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INTRODUCTION 


This manual is a guide which will assist Burroughs personnel in identifying and resolving certain prob- 
lems with the B 900/CP 9500 system. It gives both a system overview and a detailed discussion of 
the contents of a system memory dump, probably the single most effective tool available for the task 
of analyzing problems. 

This manual is divided into 12 sections and 6 appendices, A through E. 

Section 1 provides an overview of the methods by which a system dump file can be created. 


Section 2 explains the operation of the SYSANALYZER program which is used to convert the numbers 
and symbols from a hexadecimal memory dump into a format that is more easily read. 


Sections 3, 4, and 5 give an overview of system operation. Section 3 is a software overview, section 
4 discusses interprocessor communication, and section 5 discusses the theory of operation for the sys- 


tem software. 


Sections 6 through 12 discuss the actual memory dump as it appears after it has been converted using 
SYSANALYZER. 


Section 6 is titled Heading Information. This section discusses the general information contained in 
the first four pages of a memory dump. 


The next six sections of the manual discuss the major divisions of the memory dump. They are dis- 
cussed in this manual in the order in which they appear in the dump. They are: 


Section 7 - Virtual Memory 
Section 8 - Operating System 


Section 9 - Data Communications 


Section 11 - Disk Management 

Section 12 - Buffer Memory 
The appendices supply detailed information which is frequently needed as reference. 
Appendix A lists operating system error messages. 
Appendix B gives task processor error messages. 
Appendix C is a list of, and an explanation of, SYSANALYZER error messages. 
Appendix D gives techniques for user task analysis. 


Appendix E is a guide for trouble-shooting system failures. This is to assist a field engineer in making 
initial efforts to correct problems. 


Appendix F is glossary of terms. 


It is assumed that the support personnel using this manual are familiar with CMS concepts and the 
implementation of these concepts on the B900/CP 9500 system. It should be understood that this 
document is not a substitute for a properly trained software support person. 
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Related Documents 


The following manuals may be of assistance in understanding system operations: 
CMS Software Operation Guide, form 2015228-001 
CMS Data Communications Reference Manual, form 1090909 


CMS Master Control Program (MCP) Reference Manual, form 2007555-001 
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SECTION 1 
MEMORY DUMPS 


INTRODUCTION 


A system memory dump is a file created on disk containing the contents of the system memory. The 
system memory dump, in conjunction with system log files, are the most essential tools to aid in the 
analysis of system failures. It is very important that a memory dump be taken each time an unexplained 
system failure occurs. It is equally important that the dump be taken properly and contain useful infor- 
mation. This section details when a memory dump file creation occurs. Printing of the dump file is 
performed by the SYSANALYZER program, and is covered in Section 2 of this manual. 


CREATION OF DUMP FILES 


Systeii dumps are produced in three distinct ways. They may be created automatically by the operating 
system when the system detects a failure (such as Task Processor/Data Comm Processor Logically Not 
Ready, or a CLEARSTART takes place); the memory dump may be requested by the operator using 
the GT MD inirinsic, explained in Section 9 of the CMS Software Operations Guide (SOG), form 
2015228; and thirdly, the memory dump may be manually created by using the ROM/PRAM dump 
facility. This option is to be used when a system hang occurs. (System hang is defined as a condition 
where the system is unable to communicate with the operator.) It is also used when the system fails 
to automatically create a dump. Operation of the ROM/PRAM dump facility is explained in Section 
9 of the CMS SOG. 


DUMPS CREATED BY OPERATING SYSTEM 


Dumps produced by the operating system are written into a previously-assigned disk file named 
SYSDMFILEnn. This file is assigned space by the monitor Startup procedure of the OS. The decimal 
number nn is determined by startup in the following steps. 


Startup attempts to open, initialize, and close the file SYSDMFILE00; if a duplicate file condition oc- 
curs on the file close attempt, the file just created is purged and an attempt is made to create 
SYSDMFILEO01. This procedure is repeated until a successful close occurs or no file number is found 
to be available. The maximum number of system dump files allowed on the system disk is six 
(SYSDMFILE00 through SYSDMFILE05). This procedure ensures that previous valid dump files are 
not destroyed by subsequent warmstarts. If Startup is unable to find sufficient disk space, an appropri- 
ate warning message, ‘“SSYSDMFILE NOT CREATED MAX NO EXCEEDED,” is displayed on the 
Operator Display Terminal, and the system continues the warmstart. The normal operator action is 
to first reorganize the system disk so that sufficient space is available, and then re-warmstart the system 
to create a valid dump file. The OS monitor dump action can only write into a dump file created at 
the last warmstart by the OS monitor startup action. 


NOTE 
An unused system dump file is removed automatically as part of the system 
disk power-off procedures. If the system is not powered off in an orderly 
manner, or if the system hangs, an empty dump file will remain on disk. 


DUMPS CREATED BY GT MD 


The GT MD intrinsic will dump the system memory to the current dump file while the system continues 
normal operation. This can be useful in gauging system performance, and for certain types of failures 
that do not cause fatal error conditions, such as with programs that do not appear to be executing. 
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ROM DUMP FILES 


A system can be dumped to disk by use of the hardware ROM/PRAM dump facility. This ROM dump 
must be reformatted by a utility, ‘“ROMCONVERT,‘ to be identical in layout to a dump file created 
by the operating system. In this form it can be analyzed by SYSANALYZER. Operating instructions 
for ROMCONVERT are contained in the CMS SOG. 
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SECTION 2 
SYSANALYZER PROGRAM 


INTRODUCTION 


SYSANALYZER is a program which selects and prints data from a system dump file. It also performs 
some basic dump analysis by highlighting suspected system errors. This section describes how to use 
the SYSANALYZER program, and includes the format of the printed output. 


DUMP FILE REQUIREMENTS 


The SYSANALYZER program requires as input either a svstem-created dump file or a ROM dump 


file which has been converted into the format required by SYSANALYZER. This conversion process 
is performed by the ROMCONVERT utility. 


The 3.04 version of SYSANALYZER also requires that the dump file being analyzed must have been 
created on a system executing under 3.04 MCP control. 
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SYSANALYZER SYNTAX 


Parameter values are supplied to SYSANALYZER through a single BOJ initiating message. The syntax 
of this message is depicted in the railroad diagram below. The options may be entered in any order; 
the analysis takes place in the option sequence depicted in the diagram. 


SYSANALYZER 


MFID(<PACKID >) 
FID( <FILE-D >) 
ALL 


we 


en |e 
ED2644 
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CAUTION 
The options ALL and HEX are advised for analysis requested by the user. 
ALL produces a formatted full-system analysis and a hexadecimal dump; 
HEX produces a hexadecimal dump. The user is advised to ignore the more 
specific analysis options, except when otherwise requested. 


The following points should be noted: 


1. If the user enters the “‘FID( )’’ option and/or the ‘“‘MFID( )’’ with no other options following, 
only the header page and dump file information are output by the analyzer program. 

2. If the initiating message contains no options (consists only of the string SYSANALYZER), the 
system analyzer uses default values equivalent to ‘‘MFID(<system pack >), FID (SYSDMFILO0), 
ALL;” If all options are omitted, the semicolon is not included in the message. 


3. If the DK option is selected, a Hex dump of the disk processor will automatically follow the for 
matted version. 
Option Meaning 
MFID( ) The <packid> specified is the pack on which dump file resides. 
FID( ) The <file-id> specified is that of the dump file to be analyzed. 
ALL Perform analysis of: 
Virtual Memory (see VM) 
Operating System (see OS) 
Data Comm Processor (see DC) 
Task Processor (see TP) 
Disk Processor (see DK) 
Buffer Memory (see BM) 
VM Perform analysis of virtual memory. 
Os Perform analysis of operating sysiem. If no suboptions are specified, use ali suboptions. 
Suboptions of OS: 
(A) Activity management. 
(M) Memory associated with OS processor. 
DC Perform an analysis of each data comm processor. If no suboptions are specified, use all suboptions. To 
restrict analysis to individual DCPs, use the ‘‘BUS’’ option. 
Suboptions of DC: 
(DCA) Include analysis of data-comm-related parts of operating system. 
(DCP) Include analysis of data-comm-related parts of disk processor. 
(BUF) Include analysis of data-comm-related parts of buffer memory. 
TP Perform an analysis of each task processor. To restrict analysis to individual task processors, use the 
“BUS” option. 
DK Perform analysis of disk processor. 
BM Perform analysis of buffer memory 
VM Perform analysis of virtual memory. 
HEX Print an unformatted hexadecimal dump of the memory or memories specified. If no suboptions are 
specified, print a full hex dump of the system. 
Suboptions for HEX: 
(OS) Print a hex dump of memory associated with the operating system. 
(DC) Print a hex dump of memory associated with the data comm processor. 
(TP) Print a hex dump of memory associated with the task processor(s). 
(DK) Print a hex dump of memory associated with the disk processor. 
(BM) Print a hex dump of buffer memory. 
BUS(n) Each ‘“‘n” is a hexadecimal character that corresponds to a given physical bus address. When the BUS 


option is specified, only the specified bus addresses are considered to be in the dump file. 
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The BUS(n) option allows analysis of the specific task processor(s) or data comm processor(s) that the 
user wishes to examine. When this option is not used, all task processors are analyzed as a result of 
TP, and all data comm processors are analyzed as a result of DC. 


The OS processor memory must be available if the DC(DCA) or VM option is specified. To do a com- 
plete analysis of a DCP when the BUS (n) options is used, the bus address of the OS processor must 
be specified, as well as the bus address of the given DCP. 


The BUS (n) option may be used together with the ALL option. This causes a comprehensive analysis, 
but only of the bus addresses specified. 


SYSANALYZER EXAMPLE 


The following initiating messages result in the same analysis. The actual sequence of analysis is repre- 
sented by the order of the options in the second message. 


BOJ Message 1: SYSANALYZER FID(THISFIL), MFID(THATPCK), ALL; 


BOJ Message 2: SYSANALYZER MFID(THATPCK), FID(THISFIL), ALL; 


SYSANALYZER CONVENTIONS 
The reader should be aware of the following conventions which apply to the printed output: 


FORMATS OF TITLES 


Titles boxed in asterisks are titles of analysis options, suboptions, and headings of individual data 
structures. 


ERROR MESSAGE FORMAT 


ecc 
€sSa. 


Error messages are printed on the extreme left hand portion of the output listing, and are preceded 
and trailed by three dollar signs. 


BYTE REVERSAL FORMAT 

Data declared to be two-byte is stored in memory byte-reversed by the BDS processor. In order to 
provide a consistent approach to output, the following rules concerning byte reversal have been fol- 
lowed: 


1. All data read from the dump file is printed in byte-reversed form (as it was found in the dump 
file). 


2. Addresses that are calculated by the analyzer and printed in front of a dump area (in the same 
columns as data titles) are printed in a byte-forward manner. 


a4 


PRINT FORMAT 
The formatted analysis uses a global print routine to produce the printed output. The 120-character- 
wide print line is logically divided into a 40-character and an 80-character area. The 40-character area 


is used to display titles (and addresses) right-justified preceding the appropriate data. The 80-character 
area is used to print the data. The data is always printed as follows: 


<two bytes> blank <two bytes> blank ... <two bytes>. 
If the number of bytes is odd, the last <two bytes> are printed as < <single byte> blank>. The 


routine will continue on to succeeding lines, as necessary, if more than 32 bytes are to be printed. This 
routine is not used when data is printed in a table format. 


NOTE 
Disk addresses are NOT byte-reversed. 


ROMANALYZER 
A ROM-generated program may be analyzed directly by the program ROMANALYZER at those times 


when it is not possible to run ROMCONVERT. ROMANALYZER is explained in detail in the System 
Operation Guide. 
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SECTION 3 
SOFTWARE OVERVIEW 


The system firmware comprises all necessary modules to provide full CMS support. This includes: 


1, Operating system (OS). 

2. Data storage subsystem. 

3. Task processor control routines and language interpreter. 
4. System-dependent initialization routines. 


5. Data communication control, messsage handling and line protocols. 


Figure 3-1 illustrates the interrelationship of the above modules. Initialization routines are not included 


in the figure, as they are a stand-alone function. 


OS PROCESSOR 


TASK PROCESSOR 


MEMORY 
MANAGEMENT 


MONITOR 


JOB 
MANAGEMENT 


ooT—— OPERATOR ACTIVITY OATA COMM TASK PROC 
INTERFACE MANAGEMENT ACTIVITY MANAGEMENT 
iCMD 
TOD DATA PAOCESSOR PROCESSOR JOB 
WLP ACCESS INTERFACE INTERFACE CONTROL 
ut 
INTERPS 
OATA STORAGE PROCESSOR 
INTERFACE 
oPCc 
FOC 
ee _— —_ DISK CONTROL LOGIC 
Guin OTHER ACTIVITIES 
DFCM 
+—> INTERACTION BETWEEN ACTIVITIES 
?— INTER-PROCESSOR COMMUNICATION 
—-—~— PERIPHERAL INTERFACE 
E02631 
x s . . 
Figure 3-1. Software Functional Block Diagram 
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OPERATING SYSTEM (OS) 
The operating system resides in one processor/memory set. This processor maintains an interface to 
all I/O devices except the data storage subsystem and the data communication lines. The operating 
system is divided into the following modules: 

1. Operator Interface (OJ). 

2. Data Access (DA). 

3. Job Management (JM). 

4. Processor Interface (PI). 

5. Monitor (MN). 

6. Activity Management (AM). 


7. Data Comm Activity (DCA). 


OPERATOR INTERFACE (Ol) 
The operator interface module provides a communications interface between the system and a variety 
of operating processes; an example of such an interface is that between an operator and a user pro- 
gram. Included in the duties of this module are: 

1. Collecting information. 

2. Syntaxing messages. 

3. Formatting messages. 

4. Routing messages. 

5. Providing system information to the operator. 


6. Handling all 1/O to the Operator Display Terminal (ODT). 


DATA ACCESS (DA) 
The data access module provides the logical/physical interface for I/O devices (line printer, ICMD), 


and the logical interface to the data storage subsystem. Included in the duties of this module are file 
management and buffer memory management. 


JOB MANAGEMENT (JM) 


The job management module provides an orderly system environment for user jobs. It tracks the state 
of each job from beginning to end, and synchronizes the occurrence of multiple commands to the same 
job. 
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PROCESSOR iNTERFACE (PI) 


The processor interface module, in conjunction with the corresponding module in other subsystem pro- 
cessors, provides the processor-to-processor communication link. Through the use of memory mail- 
boxes, messages are transferred between processors. 


MONITOR 


The monitor module provides the capability to record, analyze, and report system events. 


ACTIVITY MANAGEMENT (AM) 


The activity management module provides the environment needed for intermodule cooperation. This 


: ; ‘ : 
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the OS modules to communicate with one another. It could be loosely regarded as the interpreter of 
the remainder of the system. 


DATA COMMUNICATION ACTIVITY (DCA) 
The DCA module comprises four major submodules: 

1. Data Comm Communicate Handler (DCCH). 

2. Data Comm Loader (DCL). 

3. Result function. 

4. End-of-job function. 
The data comm communicate handler (DCCH) provides the logic necessary to perform the functions 
indicated by a data comm communicate. These functions can be issued by an MCS or by a data com- 
munications user program. The primary function of the DCCH is to validate parameters, enforce user- 
defined limits, provide message routing to/from the data communication programs, and control the 


message interface to the DCP. 


The data comm loader primes the necessary control and routing tables to be used by the other DCA 
modules, and loads the DCP microcode and NDL tables. 


The result function provides message handling for messages sent from the DCP. This module routes 
messages and control information to the assigned programs. 


The end-of-job function performs the necessary housekeeping and deallocation of resources when a 
program terminates. 
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DATA STORAGE SUBSYSTEM 

The data storage subsystem resides in a processor/memory pair separate from the operating system. 
It works in conjunction with the operating system (OS) to provide the system with a highly efficient 
mechanism for controlling high speed storage media. Logical as well as physical control routines are 
incorporated into this subsystem. In addition, the data storage subsystem controls the display and 


maintenance routine (DMTR) module. All disk subsystems, other than the industry-compatible mini 
disk (ICMD), are connected to the data storage and maintenance processor (DS&M). 


THE TASK PROCESSOR (TP) 
User programs are executed in a separate processor known as a task processor. This processor is 
managed by the OS processor and requires the OS processor to initiate and control all its I/O requests. 
Jobs are assigned to the task processor by the job management module of the OS processor. The com- 
plete set of necessary firmware is known as the Interpreter Control Program or ICP. This set of firm- 
ware falls into two categories: control/support logic and language interpreters. The control/support 
logic can be further characterized as follows: 

1. Operating system communication (PI). 

2. Local memory management (PM, VM). 

3. Job Control (JC). 

4. Processor Management (PM). 


The MPLII interpreter is required for execution of system utility programs. The COBOL/RPG inter- 
preter is a user option that is specified in the WARMSTART information area of SYSCONFIG. 


DATA COMM PROCESSOR (DCP) 


The DCP firmware is produced by using the NDL compiler and the NPC900 program, and resides 
in the DCP. The DCP is composed of three major modules: 


1. Scheduler. 
2. Host control. 


3. Line manager. 


The internal organization of the DCP is shown in figure 3-2. 
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Figure 3-2. DCP Internal Organization 


SCHEDULER 


The scheduler module assigns processing time to the line manager and host control on a predetermined 
basis. 


HOST CONTROL 

The host control module is responsible for all external interfaces and provides support for: 
1. Request queue processing. 
2. Result queue initiation. 


3. Processor interface. 


REQUEST QUEUE PROCESS 


The request queue process submodule is primarily responsible for routing messages from the DCCH 
portion of the OS data comm activity module to the directed station. Additionally, it initiates station 


and line functions as requested. 
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RESULT QUEUE INITIATION 


The result queue initiation submodule takes complete messages, station functions, or line functions, 
and places them on the data comm activity (DCA) result queue, indicating that a complete message 
has been accumulated from a data comm line or that the requested station or line function has been 
handled. It then signals the DCA via PI.SEND. 


LINE MANAGER 


The line manager module determines if a given data comm line is currently active, and yields control 
to the appropriate NDL process (s-op handler, interrupt scheduler, or interrupt handler) at the appro- 
priate time. If the NDL process module is in control and an interrupt or a pause s-op is detected, 
the line manager module transfers control to the scheduler module. When the expected interrupt occurs, 
the line manager returns control to the NDL process. 


THE NDL PROCESS 


The NDL process is logically partitioned into three sections: s-op handling, interrupt scheduling, and 
interrupt handling. 


The s-op handler performs logical functions and initiates control of the physical data comm line. When 
code being processed by the s-op handler requires or anticipates an external event, control is relin- 
quished to the interrupt scheduler. 


The interrupt scheduler conditions the necessary hardware and logic functions to expect the event. 


The interrupt handler is invoked when the event (interrupt) occurs on the data comm line adapter. The 
interrupt handler performs implicit functions such as parity generation and checking, format validation, 
and translation. The interrupt handler invokes the NDL s-op handler to return the results of the last 
event that occurred. 


SECTION 4 
INTERPROCESSOR COMMUNICATION (PI) 


This section is intended to describe the mechanisms used in interprocessor communication. The specific 
uses made within each processor are described in section 10 of this document. 


Interprocessor communication utilizes the processor interconnect bus hardware via the interface control 
(not covered in this manual). The interested reader is referred to the B 900/CP 9500 Field Engineering 
Technical Manual Volume 3 (form 1129418). 


The interface between the DS&M and the OS does not use the mechanisms described in this section. 
A special interrupt mechanism exists between the DS&M and the Data Access activity of the OS. 


MAILBOXES 


The task processor and the DCP both have two mailboxes. The ‘‘output mailbox’’ is used for commu- 
nications to the OS processor, and the “input mailbox ’’ is used for communications from the OS pro- 
cessor. 


Each mailbox carries traffic in one direction, but has a standard layout of bytes and their functions: 


Field Bytes Use 


Text 16 Contains the actual text passed. For a CMS communicate this will be the 
communicate parameter area (CPA). 


Request function This is the action id or name that this message was directed to. 


Request processor This is the bus address that this message was directed to. 


This is the action id or name that this message originated from. 


i 
i 

Result processor 1 This is the bus address that this message originated from. 
Result function H 
1 


Where appropriate, this will contain the task id of the job initiating this 
communication. 


System mix number 


Reserved 1 
Flags I These flags define the status of the mailbox. 


The values are as follows: 


MSB 7 = Request message 

6 = Unused data comm processor 

5 = Task processor error 

4 = Task processor rejected 

3 = Operating system accepted 

2 = Given to operating system 

1 = Task processor accepted 
LSB 0 = Given to task processor 


The request and result function fields contain an action name or action id dependent on the original 
request. In general, a response to a previous communication is directed to an action id, and an original 
request is directed to an action name. For CMS communicates, this id is @FF@. 


The flags are used to specify current ownership of the mailbox. The OS processor always uses the mail- 
box in the other processors. 


See Section 10 of this manual for further details of mailbox functions. 
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SENDING A MESSAGE 
OS TO TP 


The procedure is as follows: 


OS 
OS 
OS 


TP 


TP 


1. Check status of input mailbox of desired TP. If not ok then wait. 
2. When ok, insert text. Reset OS accepted. Set given TP. 
3. Interrupt TP. Wait. 


4. If handler not available, mark mailbox as TP rejected, interrupt OS; OS will reset TP re- 
jected, set OS accepted. Wait, then retry. 


5. If handler is available, will set TP accepted, initiate appropriate function, and interrupt 
OS; OS will mark box as OS accepted, and finish the send function. 


TP TO OS 


The flow is almost a reverse of the above: 


TP 


TP 


OS 


TP 


1. Set up output mailbox (if owned by TP). 
2. Set given OS, interrupt OS. 
3. Copy message in, set given TP, interrupt TP. 


4. Set TP accepted, inform caller. 


Os TO DCP 


OS 
OS 
OS 


OS 


1. If OS doesn’t own mailbox, wait. 
2. Copy message into mailbox. 
3. Set given TP, request message, reset other flags. 


4, Interrupt DCP. 


DCP 5. Set given OS, reset request message, interrupt OS. 


OS 


6. Set OS accepted. 


DCP TO OS 
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DCP 1. If output mailbox is not owned by the DCP, look for something else to do. 


DCP 2. Else, set up mailbox, clear flags. 


DCP 3. Set given OS, interrupt OS, forget it. 


OS 4. Copy in, set given TP. Continue. 


TRANSFERRING DATA 


Data transfer is not a PI function; however, interprocessor communication is usually needed before 
such a transfer can take place. 


Data is transferred via the bus under the control of the OS processor. During transfers from disk to 
any memory, the requesting processor is responsible for freezing the appropriate memory area, and 
is expected to leave it alone until informed otherwise by the OS processor. This mechanism is transpar- 
ent for data file I/O as buffer memory is an OS-managed entity, but is not transparent for code or 
data segment I/O. 


Note that any processor may attempt a remote access. Each processor is required to adhere to the re- 
strictions imposed by the OS processor. 
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SECTION 5 
SYSTEM SOFTWARE THEORY OF OPERATION 


OS OVERVIEW 

The OS may be considered to operate using three levels: 
Activities 
Actions 


The kernel (nucleus) 


ACTIVITIES 
Activities are groups of actions and are committed to specific functions, specifically: 
OI -Operator Interface 
JM -Job Management 
DA -Data Access 
DC -Data Comm 
MN -Monitor 


AM -Activity Management 


An action is a region of code which may be given control of the OS processor. In practice, an action 
is a procedure that is executed by the Activity Management procedure ‘‘INVOKE.”’ The different types 
of actions are defined as follows: 
AVAILABLE ACTION: A region of code that is called upon to perform some specific functions. 
EXECUTING ACTION: An instance where it was decided to use a specific available action. 
CRITICAL ACTION: An action that cannot be invoked if it is already executing. 


CONTINUOUS ACTION: An action that never yields the processor voluntarily. 


KERNEL 


The kernel, or nucleus, is a microcoded area that contains commonly used routines. Some of these 
routines have responsibility for interactivity communication. With the exception of the monitor activity, 
no activity may directly contact another, it must call a specific nucleus routine to perform the switch. 
(See figure 5-1.) 
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Figure 5-1. OS Overview 


The nucleus is considered part of the AM (Activity Management) activity, and is permanently resident 
along with the other activity management functions: AM actions, real time clock (RTC), virtual mem- 
ory (VM), and processor interface (PI) at the low end of page 0. 


Routines within it maintain tables, lists, and queues on behalf of AM, and also control the invocation, 
scheduling, and deallocation of actions. These routines will apply available memory for use by actions, 
invoking if necessary the more complex VM routines to make the space. 


An area known as a “‘status block’’ is created for every action. The size of a status block is specific 
to a given action. As shown in figure 5-2, each status block is divided into three logical sections: comm 
area, control area, and stackframe. Of these, only the size of the stackframe may vary from action 
to action. The status block, as its name implies, is used to hold the status of the action when it be- 
comes suspended, as well as the communication parameters it receives or wishes to send to another 
action or micro routine. 
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Figure 5-2. Status Block Layout 


One to four workblocks may be associated with an action. They are accessible only to the action and 
activity management, and are used to hold the data pertinent to the action. It is possible for a work- 
block to hold data which may be used to supplement comm area data when one action calls another. 


A link block is a work block which an action or AM has deemed necessary to be in scope to the whole 


of an activity. Before an action may manipulate the contents of a link block, its status must be re- 
turned to that of a work block. 


VM 


VM is responsible for making space if required, maintaining descriptors and links for these, and return- 
ing space. 
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PROCESSOR INTERFACE (PI) 


PI controls interprocessor communication. It scans two arrays, one for input, one for output. On de- 
tection of a processor’s readiness to send or receive a communication, it will: 


1. Read that processor’s output mailbox. 


2. Write to that processor’s input mailbox if a message is available. 


Message transfers in either direction are monitored by a system of acknowledgements. 
AM__ACTION__LIST POINTERS 


In order to keep track of the location of the status blocks, a list of pointers to them is kept resident 
in memory. The maintenance of this list is the responsibility of routines within the nucleus. The list 
consists of 100 two-byte entries @00@-@64@. Each entry is the absolute memory address of its associ- 
ated status block. The first fifteen entries are for resident actions (one continuous, and fourteen 
critical). Refer to figure 5-3. 
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Figure 5-3. Action.List Pointers 
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The continuous action may, in fact, be any of four which are designated ‘‘continuous.’’ Only one may 
run at a time, so they share a status block. This status block is permanently located in a fixed location 
within AM resident area. The continuous action will always run to completion without yielding the 
processor to another action. Entries @01@ thru @OD@ are for the ‘‘critical’’ actions; @OE@ is a 
critical action reserved for future use. These are actions of which only one invocation may exist at 
any time. These actions may yield the processor. 


Entries @OF@ thru @64@ are assigned on an as-required basis. They will always be in overlayable 
memory. However, all status blocks with their associated work and link blocks, will always be located 
on page 0. 


STATUS BLOCK LINKING 


OS operation consists of the serial running of actions, with interspersed nucleus code. Within the nu- 
cleus is ‘‘scheduler’’ code, which determines the order in which actions are given control. Scheduler 
scans through the status blocks to find one which indicates by its status byte that the associated action 
is ready to run. 


All current actions will be linked together in a circular list, only critical actions which are active will 
be included. The linking mechanism is the ‘“‘LINK1”’ byte, containing the “entry number’’ of the next 
action on the list. (Refer to figure 5-4.) 
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Figure 5-4, Status Block Linking 


1118478 5-5 


9-5 


£D2637 


AM.NORMAL.HEAD 


AM.SHORT.DELAY 


AM.LONG.DELAY 


LONG DELAY 


SHORT DELAY 


LINK 2 ENTRIES 
LINK 1 ENTRIES 


ENTRY NUMBER ON AM.ACTION.LIST 


Figure 5-5. Normal and Suspension Queue Links 


It may be that an action wishes to invoke a critical action which is already running, or wait for some 
system event to occur. In these cases, a queueing mechanism is used, and the entry number or the 
next action in the queue will be in the status block ‘‘LINK2”’ byte. There are a large number of possi- 
ble queues, as can be seen from a look at the dump. The above description is only intended to describe 
the linking mechanism for each queue, as shown in figures 5-5 and 5-6. 


The entry number, then, is used as an index into the AM.ACTION.LIST pointer table which contains 
the absolute memory locations of the status blocks of current actions. 
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Figure 5-6. AM.QUEUE.HEADS 
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LINKING 


Structures within overlayable memory are linked together in two distinct lists, depending on their form. 
Although the linking system is basically similar, there are some differences as outlined below. 


AVAILABLE 


Each available block of memory contains within it a descriptor. This descriptor is five bytes long and 
is the first five bytes in the block. It contains type (available), size (physical), and absolute address 
of next available descriptor. The chain starts from the available head pointer which points to the avail- 
able table. This table contains one entry for each page of memory; thus, available memory linking is 
on a per-page basis. The entry in the table for each page points to the descriptor of the first piece 
of available memory on that page. The last available area on a page is linked to @FFFF@. 


WORK BLOCK/LINK BLOCK 


Each work or link block is immediately preceded by a three-byte descriptor indicating type and size. 
The main information about the block is held in a 10-byte descriptor. This descriptor also holds a 
pointer to the next descriptor in the chain. The head of the chain is pointed to by the ‘“‘WB.LB Point- 
er.’ (Refer to figure 5-7.) 


It should be noted that the size may be indicated differently in the 10-byte descriptor and the three- 
byte descriptor. The three-byte descriptor contains ‘“‘physical size,”’ while the 10-byte descriptor con- 
tains ‘‘logical size.’’ The discrepancy occurs as follows: 

1. Area of 200 bytes needed. 

2. Thirteen bytes must be added for descriptors; look for 213 bytes. 


3. Find available of 217 bytes. 


4. Since surplus bytes <5 (minimum requirement for ‘‘available’’ descriptor), use this area. 


Wn 


. Create and mark 3-byte descriptor with size = 207 bytes (physical). 


6. Create and mark 10-byte descriptor with size = 203 bytes (logical) and pointer to start of area 
(not to 3-byte descriptor). 


NOTE 
Such a three-byte descriptor always immediately precedes the area it de- 
scribes. The 10-byte descriptor may be anywhere. 
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SEGMENT TABLE 


All OS data segments must reside on page 0. Code segments may be on any page. A segment table 
exists in the resident area for determining the presence and location of either structure. (Refer to figure 
5-8.) This table contains 136 entries which for any given release will be in the same order. It is indexed 
into by the segment number. Before accessing a segment, a test is performed on its descriptor to deter- 
mine if that segment is present. If so, its location in memory, held within the descriptor, is valid. 
If not, the disk address and size will indicate its location on disk. An absent segment will have a mem- 


ory address of @FFFF@. 
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Figure 5-8. Segment Table Block Diagram 
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TASK PROCESSOR 


Communications between the OS and the TP take place through PI, except for movements of data 
which are initiated by a PI message but are performed by actions internal to OS or TP. 


Messages received from the input mailbox of the TP go to one of four functions. These functions are 
interpreter load, monitor, command handler, or data move. 


The interpreter load function is responsible for loading the interpreters at warmstart time. The monitor 
function handles polling from the OS. The command handler function breaks down its own parameters 
to determine the precise request being made by the OS. Data move is responsible for the movement 
of data between the OS and the TP. 


Responses to OS communications are returned to the OS by way of PI. The action in the OS to which 
the response is to be routed is part of the data contained in the output mailbox of the TP. 


The TP does not run with the same action structures as the OS. Only the interface mechanisms are 
common to both. The rest of the TP may be considered a completely separate entity. Figure 5-9 is 
a block diagram of the TP, showing the OS-to-TP interface, the TP functions, and the TP-to-OS inter- 
face, via PI. 


A task record is maintained for each TP task. Only two tasks are considered to be “‘resident’’ and 
have task records permanently assigned These tasks are named ‘‘OS REQUEST TASK” and ‘‘TER- 
MINATE TASKS TASK.”’ Entry numbers indicating TP-relevant tasks are found in the JOB QUEUE. 


eae is a pointer to a system task, and may be converted to a user mix number by use of the mix 
table. 
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Figure 5-9. Task Processor Job Control Activity 
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SECTION 6 
HEADING INFORMATION 


INTRODUCTION 


This section presents a description of the first four pages encountered in a system dump. The first page 
is the title page, which identifies the dump file being analyzed, and indicates when the dump was cre- 
ated. The second page, titled ‘‘Dump File Parameters,’’ contains data detailing the structures found 
within the dump. Page three is a brief section containing dump file map definitions, and page four 
is the dump file map. The dump file map provides the status of the processors and associated memories 
at the time the dump was taken. The relevant fields in initial dump analysis are discussed in the fol- 
lowing paragraphs in the order in which they appear in the dump. 


TITLE PAGE 


The title page contains information relevant to the dump file being analyzed. The initiating message 
to the SYSANALYZER program is printed first. This will indicate which portions of the dump were 
requested to be printed. The fields ‘‘dump file creation date’’ and ‘‘dump file creation time’’ can be 
used to determine if the dump was created by the ROM/PRAM routine or by the system. If these 
fields contain a valid date and time, the dump was created by the system. This could have occurred 
either automatically, due to a system failure, or by the operator’s use of the GT MD intrinsic. If the 
date is given as 11 11 11 and the time is given as 24.00.00, the dump was most likely created by the 
ROM/PRAM dump routine. It is also possible that the failure occurred prior to the input of the date. 
On a remote SPO system it is not mandatory to enter in the date and time; therefore, the dump could 
contain 1! 11 11 as the date and 24.00.00 as the time. Refer to figure 6-1 for an example of a title 


page. 


BOJ MESSAGE ALL, HEX 
DUMP FILE PACK ID 0Gv000G 
DUMP FILE ID SYSOMFILEOG 

DUMP FILE CREATION DATE 82 08 13 

DUMP FILE CREATION TIME 14 32 05 

ANALYSIS DATE 82 08 143 

ANALYSIS TIME 14 13 U4 

KEVISTON LEVEL 03.04.10 


Figure 6-1. Title Page Messages 
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DUMP FILE PARAMETERS 


This area contains pointers to various structures within the operating system, most of which are used 
in a hexadecimal dump analysis. Some of the fields in the dump file parameters sections are irrelevant 
for an initial dump analysis. Those that are most important are: 


Version String 
System Error Value 
Frozen Processor 
Frozen State 


The dump file parameter fields are discussed in the following paragraphs in the order in which they 
appear in the dump file. Refer to figure 6-2 for a sample dump file parameter page. 


ANALYZER LEVEL 


The analyzer level is a one-byte field which is checked by SYSANALYZER. If the level in the dump 
file does not match the SYSANALYZER level, an analysis of the dump will not be performed. 


VERSION STRING 
This field identifies the level of the MCP in use when the dump file was created. 
SYSTEM ERROR VALUE 


AA watniene 


@FF@. 
FROZEN PROCESSOR 


This field gives the bus address of a processor that has been frozen by the operating system. Other 
sections of the dump may show why the processor was frozen. 


FROZEN STATE 


The contents of this field indicate the state of the frozen processor identified in the preceding field, 
“frozen processor.’’ The values for the processor state are found under ‘‘Dump File Map Definitions.” 
It should be noted that a fatal failure in a task or DCP processor always results in an attempt to pro- 


duce a system dump file. 
PROCESSOR TYPES 


The processor types field is a 16-byte array. Each byte represents a zero-relative bus address. An 
unused entry contains @FF@. Valid entries are described under Dump File Map Definitions. 


REMAINING DUMP FILE PARAMETERS 


The remaining dump file parameters are used for in-depth analysis, generally in conjunction with a 
hex dump. 


RRRARKEKRKEKEEKAAKEKEEK 


OUMP FILE PARAMETERS 
Ree REAERARAERARA 


ANALYZER LEVEL 

VERSION STRING 

SYS¥EM ERROR VALUE 

FROZEN PROCESSOR 

FROZEN STATE 

PROCESSOR TYPES 

DATE & TIME 

ACTION LIST POINTER 
NUMBER OF ACTIONS 

COMM BASE POINTER 

CURRENT ID POINTER 

VM BASE PAGE O 

VM BASE NON PAGE 0 
WAITING HEAD POINTER 
NCRMAL HEAD POINTER 

QUEUE HEAD POINTER 
NUMBER OF CRITICAL QUEUES 
LAST QUEUE POINTER 
NUMBER OF SCHEDULE QUEUES 
LONG DELAY POINTER 

SHORT DELAY POINTER 

WB/LB HEAD POINTER 

WB/LB ENTRY SIZE 
AVAILABLE HEAD POINTER 
AVAILABLE ENTRY SIZE 
SEGMENT TABLE POINTER 
SEGMENT TABLE ENTRIES 
SEGMENT ENTRY SIZE 
INTERRUPT HANDLER POINTER 
INTERRUPT HANDLER SIZE 
MAX USER JOBS 

DC DATA POINTER 

OC DATA END ADDRESS 
EVE ADBRESS POINTER 
DC POINTER POINTER 

HISTORY COMM TABLE POINTER 
PI POINTER 

Ie ws 

ID JM 

ID DA PROG NAMTAB 

ID DA INTERP NAMTAS 

ID DA MESC NAMTAB 

1D DA LUAIT 

Id OF 

Id SM 

DC LINE POINTER 

NUMBER OF EVENT QUEUES 
PORT TABLE POINTER 
PERIPHERAL TABLE POINTER 
DA~CT.POINTER 

Id DE LIST 

DA BUFFER POINTER 

NUMBER OF PI QUEUES 

OOT SEG PTR 

PERIPHERAL LOCKS 


03 
3033 3934 3233 3053 3230 3130 3030 
FF 
FF 
FF 


FFOT 0304 0303 0305 O2FF FEFF FREF FEEE 


0813 8219 1412 0572 
Oa23 


Figure 6-2. Dump File Parameters 
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DUMP FILE MAP DEFINITIONS 


The type key may indicate the type of area that is dumped, or it may indicate termination. The type 
key values are as follows: 


@01@: Page of memory 


@02@: Data block/work block/linked block area. Data block is part of the operating system’s vir- 
tual memory file; work block/linked block are defined in Section 3. 


@03@: Terminated with no errors 


@04@: Terminated due to parity errors 


The validity flags and their meanings are: 


@FF@ __ Incomplete: The area that follows is the last area dumped, and is probably incomplete 
because of a system or disk crash. 


@00@ _~=—«*Vallid: The area that follows has been completely dumped with no errors 


@01@_siInvalid: The area that follows had disk errors during dump. Go on to the next id sector. 
The same area will be dumped again. Only one retry will be done before the dump 
is terminated and a type key of ‘‘terminated with parity errors’’ is written. 


The processor state values are outlined in figure 6-3. 
DUMP FILE MAP 


This table provides the status of all the processors and memories on the system at the time the dump 
was created. Using the fields bus address, processor type, and last address, the configuration of the 
system can be ascertained. The ‘‘Last Address”’ field is used to calculate the amount of memory as- 
signed to each processor. A normal 64K page will have the value @FOFF@ (byte-reversed), and for 
depopulated boards, the last address should be on a 16K boundary. If the last address is any value 
other than previously stated, it means that an error was detected when attempting to dump that page. 
The error being detected is at the address contained in “Last Address.’? The amount of buffer memory 
assigned can be ascertained by a processor type of 05 (BM). In a ROM/PRAM dump, buffer memory 
is not evident. A dump file map is shown in figure 6-4; see figure 6-5 for an example of a processor 
status decode section. 
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RKRERKKEKKRENEAREKKARKAKDAT 


DUMP FILE MAP DEFINITIONS 
AAARAAAARANAAAA RAR AR EERE 


TYPE KEY 


VALEOITY FLAGS 


PROCESSOR STATE 


O01 — PAGE OF MEMORY 
O2 — DATA BLOCK 


03 -— TERMINATED WITH NO ERRORS 


04 — TERMINATED DUE TO PARITY ERRORS 


00 - VALID 
01 — INVALIC 
FF - INCOMPLETE 


OG — FROZEN / REGISTER STATE SAVED 
O01 — FROZEN / REGISTER STATE UNSAVED 


O2 — UNFROZEN / SOFTWARE ERROR 


FF - OK. 


Figure 6-3. Dump File Map Definitions 


RAE HERAKRKKKSE 


DUMP FILE MAP 
ke khkkkekabae 


BUS PAGE PROCESSOR 


KEY FiAGS ADDRESS ADCRESS STATE 
aks Anddk RRDRARK ARAAKEA AAR ARAE 


01 00 O1 60 FF 
04 G6 o7 01 FF 
o1 00 O01 02 FF 
Gt oo 01 03 FE 
07 00 02 00 FF 
01 oo Oe a1 FF 
Q1 60 02 02 FF 
61 00 G2 03 FE 
OT 00 03 00 FF 
ot 00 04 00 FF 
01 00 04 01 FE 
01 00 04 02 FF 
01 00 04 03 FF 
Ot 00 05 00 FF 
01 00 a5 01 FE 
Ot 00 05 02 FF 
GI 00 05 03 FF 
01 60 06 ou FE 
01 00 06 Ot FE 
ut 00 06 02 FF 
01 00 06 63 FE 
01 oo 07 00 FF 
Of 00 07 01 FF 
01 00 08 oo FF 
02 00 00 

03 00 00 


PROCESSOR PROCESSOR 
STATUS TYPE 
ARRARAREE | RERRARERA 
81021181 Os 07 
31021161 os O1 
81021181 os 01 
810211B1 Os 01 
81008FA2 TP 03 
8TOU8FA2 TP 03 
81008FA2 TP O3 
81008FA2 Te 63 
81008F 73 DK O04 
81008F64 TP O03 
81008664 TP O03 
81008F64 TP 03 
81008F64 TP 03 
81028F05 TP O3 
81028F05 TP 03 
81028F05 TP Q3 
81028F05 TP 03 
81008 F06 TP 03 
&1008F06 TP O03 
81008 F06 TP 03 
81008F06 TP O3 
2TOODF TI? BM 05 
21000F 17 BM O05 
AT008FT8 DC 02 


Figure 6-4. Dump File Map 
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LAST 
ADDRESS 
RaRRAER 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FOFF 
FESF 
FOFF 
FEFF 
FEFF 


DISK 
RECORD 
RAKES 
0003 
0177 
O20F 
044D 
0588 
0729 
0897 
GAGS 
0673 
OCE? 
QE4F 
OFBD 
1128 
1299 
1407 
1575 
16E3 
1851 
19BF 
1B82D 
1C9B 
TEO? 
1F7?7 
TFD4 
2142 
2204 
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PeUveESe ere Cer ree lea Las S| 


FROCESSOR STATUS DECODE 


ee SHARRERAAAAARSHAAREA AE 


PROCESSOR 
PROCESSOR 
PROCESSOR 
PROCESSOR 
PROCESSOR 
PROCESSOR 
PROCESSOR 


PROCESSOR 


ON 
ON 
ON 
ON 
ON 
ON 


ON 


ON 


BUS 
@us 
BUS 
BUS 
BUS 
BUS 
BUS 


BUS 


01 
G2 
03 
04 
05 
06 
07 


08 


Figure 6-5. Processor Status Decode 


NPRG CONNECTED 
OS SUBSYSTEM 
NPRO CONNECTED 
OS SUBSYSTEM 
NPRO CONNECTED 
DISK SUBSYSTEM 
NPRO CONNECTED 
DISK SUBSYSTEM 
NPRO CONNECTED 
NPRO CONNECTED 
FROZEN 

RAM FETCH 

NPRO CONNECTED 
RAM FETCH 


RAM STATE 

TOS CONNECTED 
RAM STATE 

TOS CONNECTED 
RAB STATE 

10S CONNECTED 
RAR STATE 

10S CONNECTED 
RAR STATE 

RAM STATE 

RAM STATE 
CONTROLS 1/0 
FROZEN 
CONTROLS I/C 


REMOTE ACCESS 
CONTROLS 1/0 
LOCAL ACCESS 


LCCAL ACCESS 
CONTROLS 1/0 
LOCAL ACCESS 


LOCAL ACCESS 
LOCAL ACCESS 
LOCAL ACCESS 


RAM STATE 


RAM FETCH 
RAM FETCH 
RAM FETCH 
RAR FETCH 
RAM FETCH 
RAM FETCH 


READ WITH CLEAk 


LOCAL ACCESS 


SECTION 7 
VIRTUAL MEMORY 
INTRODUCTION 


This section of the manual provides a field-by-field description of the Virtual Memory portion of a 
dump. This area of the dump is composed of six tables, which are maintained by the MCP, indicating 
the status of the system at the time the dump was taken. The tables are: 
DA_PROG_NAMTAB - Program Name Table 
DA_INTERP_NAMTAB - Interpreter Name Table 
DA_MISC_NAMTAB - Miscellaneous Name Table 

MIX TABLE 

PORT TABLE 

PERIPHERAL TABLE (PHT)- Peripheral Hai 


eh Bee wm. tt 
UNM Ladle 


Under heavy system activity, it is possible for some of these tables to be swapped out to disk (backing 
store). When this condition occurs, these tables are located towards the end of the SYSMCP file. In 
a system dump, both “Copy in Memory” and “‘Copy on Backing Store” are printed unless the tables 
have been swapped out of memory. When both are present, Copy in Memory is the most recent version 
and is the one which should be analyzed. Copy on Backing Store is never printed in a ROM dump. 


The reason for this is that the links which point to the location on backing store are cleared in the 
process of taking a ROM dump. 


Initial analysis of the Virtual Memory section consists of scanning the MIX TABLE, PORT TABLE, 
and the Peripheral Table (PHT). 


An examination of the MIX table shows the number of programs in the mix and their status. More 
specifically, the “MIX PROCESSOR” field gives the bus address of the task processor executing a 
specific program. The Port Table identifies the devices on the “soft” ports. The PHT indicates the 
physical status of all peripherals connected to the system. This table should be used in conjunction 
with the Device Configuration Table (DA_CT), which gives the logical status of the peripherals. 


A detailed description of the virtual memory tables and their fieids as they appear in a dump is contained 
in the subparagraphs which follow. 
DA_PROG_NAMTAB 


This table is a list of all open code files. A sample DA_PROG_NAMTAB is supplied in figure 7-1. 
DA_INTERP_NAMTAB 


This table is a list of all loaded interpreters. A sample DA_INTERP_NAMTAB is supplied in figure 


DA_MISC_NAMTAB 


This table is a list of all opened miscellaneous files: for example, log files, SYSLANGUAGE, SYSDM- 
FILEnn, etc. Refer to figure 7-3 for an example of the DA-MISC_NAMTAB. 
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MIX TABLE 


The mix table is an internal array record of each job. It has one entry for each program in the system. 
The job management activity of the operating system controls the maintenance of this table. The fol- 
lowing fields are used by Job Management in performing its functions. These fields appear in the dump 
analysis in front of the first mix table entry break down. 


Sample Mix Table entries are outlined in figures 7-4 and 7-5. 


MAX JOBS This fleld Indicates the maximum number of 
Jobs (In hex) allowed In the mix. 


NULL MIX RUNNING This fleld is set true (@FF@) If the 
current Job requires a null mix In which to 
rune 

JOB COUNT This fleld Indicates the number of Jobs in 


the mix, Including SUPER*UTILITY. 


MCS COUNT Contains the number of MCSs running In the 
mixe 
TEMPORARY 1D This fleld temporarily holds values during 


the loading of a Job. 


NEXT MIX NUMBER This fleld Is the mix number of the next 
Job to be loaded. 


COUNT WAIT JOBS This fleld contains the number of Jobs 
walting to be assigned a processor to run 
Ine 

RESTART 1D This fleld contalns the action Id of the 


restart action. 


INTERPRETER ARRAY 0,1 This fleld contains the file Information 
block fds of the Interpreter. 


SUPER FUNCTION This fleld contains the current SUPER=- 
UTILITY function, such as PD. If the field 
Is blank, the SUPER=-UTILITY Is Idle. 


The following fields are contained In a mix table record: 


MIX TABLE ENTRY/TASK 1D This fleld contains an Index Into the mix 
table. It points to the mix table entry 
for this Job (Itself). 


PROGRAM FIB 1D This fleld contains the id of the file 
Information block for the program (code) 
fllee It Is used In opening and closing 
the program file. The left hand byte Is 
the entry number In the DA_PROG_NAMTAB. 
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vM FiB 1D 


INTERPRETER FIB 10 


MiX NUMBER 


MIX FLAGS 


This field contains the id of the file 
information block for the virtual memory 
file. It Is used In opening the VM file. 
The left hand byte is the entry number In 
the virtual list and should be the same as 
the task Id. 


This fleld contains the Id of the file 
Information block for the Interpreter file. 
It Is used [In opening and closing the 
Interpreter files The left hand byte Is an 
Index Into the DA_INTERP_NAMTAB. 


This fleld contalns the mix number assigned 
to the task at load timee This ts the 
number the user uses to refer to the Job. 
Note that this Is In hex. 


These reflect the state of a Job. 


Any reasonable combination of these flags 
Is permitted. 


@8000@ : £0J terminating 


440008 DP terminating 


@2000@ =: DS terminating 
€1000@ : Terminating (accompanied by 


one of the above) 


@0so0@ : B0J/EOJ message suppress 
@04008 : Data comm Job 

@0200@ : MCS 

@0100@ : Multicopy 

@0080@ : Thrashing 

@00406 : Null mix required 
@0020@ : Paused 

@0010@ : Terminate with lock 
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Mix Flags 2 


MIX STATE 


MIX PROCESSOR 


MIX INTERPRETER 


MIX PRIORITY 


eocose : EX pending 


400048 PR pending 


400028 


ST pending 
@0001é : GO pending 
@0000@ : None of the above 
lf thts fleld = 01 then the task Is a 
remote SPO handler. 
This reflects the current state of the Job. 
possible values are: 
e0oi@ : Loading 


4026 


Waiting (not assigned to a TP) 
e03@ : Awaiting run 
@04@ : Executing 


a05e 


Awalting remove 
@06@ : Stopped 
@07@ : Unloading 


a0se 


Awalting suspend 


eoce : Suspended 


This fleld Indlcates the processor which Is 
running this Job. 


This fleld holds the Index into the 
interpreter assoclated with this job (index 
Into Interpreter array). 


The low order digit of this field Indicates 
the priority of the Job as follows: 


Priority ¢ 
Priority B 
Priority A 
I} legal priority 


PWN = 
oe 0 oe 


A @C@é In the high order digit Indicates 
that this Job may open any file; @8@ In 
this digit means this Job can open any file 
but system. 


MIX TCB SIZE This fleld Indicates the size of the task 
control block- It Is used by Job 
Management when passing the Job to the task 
processor to run. 


MIX PARENT POINTER This fleld contains the task Id of the 
parent Job if this Job was started by a zIp 
with pause. 

REAL STORE Holds the working set estimate specified at 


Job execution (If given). 


SPO SIZE Reserved for future use. 


PORT TABLE 


This table lists the number of devices associated with a port and the number of users for the device 
and the actions executing for the port. 


The “index” is the index into the DA __CT table. DEVICES gives the number of devices associated with 
this port, thus the number of entries in the DA_CT, index 00 point to first entry in DA_CT. If 
DEVICES = 2, two entries will appear in DA_CT, both controlled by the controller indicated in port 
table TYPE column. 


NOTE 
Variations from above are devices that do not appear in DA_CT. They are: 


Entry 00 = Pl 
Entry 01 = OP 
Entry 02 = TOD 
Entry 03 = ODT 


Refer to figure 7-6 for a sample Port Table. 


PERIPHERAL TABLE (PHT) 
This table contains device status information. The individual fields of an entry are explained below. 


The first grouping of four data items contains information about the disk file header locks. These locks 
prevent concurrent access to the disk file headers for a particular file during Open, Close, or Disk Area 
Allocation. Each lock is three parts: a SYSMEM flag, task byte, and a FILETAG. 


Refer to figure 7-7 for an example of a PHT entry. An explanation of the individual entries fol - 
lows: 
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PERIPHERAL TABLE (Cont.) 


NUMBER 
PERIPHERAL 
LOCK 


SYSMEM 
FLAGS 


TASK BYTES 


LOCK BYTES 


ENTRY/DA CT INDEX 


FORCE STATE STATUS 


STATUS 


UNIT/PORT TABLE INDEX 


This byte contalns the number of locks. This value Is 
used by the dump analyzer to compute the sizes of the 
Individual Ifsts that comprise the locks. This value 
Is the number of bytes In the SYSMEM flag and task byte 
lists and Is one-fourth the size of the lock byte list. 


These flags are used by OPEN SYSMEM LOCK as an 
indication that all directory activity for a unit belng 
locked has ceasede When Open wants to OPEN SYSMEM LOCK, 
the SYSMEM flag Is set (@FF@) for each lock that Is not 
avallable (an avallable lock has Its corresponding 
four-byte FILETAG entry In the lock bytes binary zeroed 
out). The Open delays until all of thes SYSMEM flags 
have been reset. It then continues with the Open. 


The task bytes contain the Internal task number of the 
job that is currently holding a locke When a lock Is 
freed, the lock maintenance code nsures that the task 
id of the lock holder matches the task Id of the lock 
freere If they do not match, a clearstart results. 


The lock bytes contain the FILETAGs for the files 
that have currently locked headers.s When Open, Close, 
or Allocate attempt to unlock or lock a file header, 
the FILETAG is passed from the FIB. 


Tne contents of this fieid fs an index into 
the configuration table, DA CT. 


This field Indicates whether the device Is 
physically ready, physically not ready, or 
unavatlable ; 


a00@ : Physicaliy not ready 
@oi@ : Physically ready 
@FF@ : Not avallable 


This field indicates the status of a 
devices The analyzer only lists this field 
for the devices that are marked physically 
not ready. The flag values are: 


(MSB) 0 : Device post needed 
1: AVR needed 

2: Last status noticed 

3 Illegal PO flag 


This fleld Is an Index Into the port table, 
as followse The righthand digit Is the port 
number and the lefthand digit Is the device 
number within that porte 


PERIPHERAL TABLE (CONT.) 
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QUEUE HEAD, 
TAIL, & CURRENT 


QUEUE STATUS 


AM-ACTIONeLIST INDEX 


RETURN STATUS 


MSB 


These flelds point to the queue of 1/0°s 
that are outstanding for thls device. If 
the queue contains any entries, they are 
analyzed here. 


This fleld reflects the status of this 1/0. 


@00@ : New 
@0i@ : In process - by the controller 
@024@ : Complete 


@03@ : Complete and dequeued 
(delinked from queue but still 
In buffer memory) 


This fleld contains the action Id of the OS 
action associated with this 1/0. 


This is a three-byte field which fs the 1/0 
status returned for the last operation 
performed. (This fleld tsonly valid with a 
queue status of 20r 3.) This field Is 
decoded as follows: 


byte 1 : @00@ Controller error (internal to DP) 


401@ Command successful 

@02@ Command unsuccessful 

@03@ Device error, aborted command 
@04@ Not used 


@05@ Descriptor error 


byte 2 : @00@ No error 


@01@ Seek timeout 

@02@ Head off cylinder 

@03@ Sequence error (internal to DP) 
a04@ = Parity 

@05@ Sector not found 

406@ illegal address 


@07@ Status word error(internal to DP) 
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PERIPHERAL TABLE 


7-8 


(CONT.) 


@08@ Data error (in compare) 


a09e@ Write Inhibited 


byte 3 : Retry count 


QO Read data 
1 Write data 
3,4 Search less than 


This fleld contains the op code of the 
command the device was executinge The 
following Is a list of acceptable 1/0 
commands : 


9,10 Search less than or equal 
11,12 Search greater than or equal 
13. InItlalize 


5,6 Search greater than 14 Lock door 


7,8 Search equal 


BUFFER ADDRESS 


SIZE PARAMETER 


DEVICE-DEPENDENT 
PARAMETERS 


For Disk: 


15 Unlock door 


During a search operation the 2 bit Is used 
to condition read operations. If set, the 
hit sector will be read; If reset, It will 
not be read. 


This [s a 6ebyte fleld. The first two 
bytes Indicate size. The second two bytes 
Indicate BUS/PAGE, and the last two bytes 
Indicate offset. 


This Is a 2=byte field Indicating total 
buffer slze-. 


Byte 1-3 Sector address 
4 Key Jength 
5 Key displacement 
6 Key record length 
7-9 MIR status 


For Tape Descriptor Format: 


The tape 1/0 descriptor differs from the 
disk 1/0 descriptor format in the Return 
Status flelds, the CPCODE, and the Device 
Dependent Parameters. 


RETURN STATUS 
Byte 1 + Command Status 
@006 - 1/0 Controller Error 
@01@ - 1/0 Completed ok 
@03@ - 1/0 Device Error 


PERIPHERAL TABLE (CONT.) 


@048 
e056 
8068 - 
e076 - 


Tape Mark Read (end of file) 
1/0 Descriptor Format Error 

End of Tape Sensed 

1/0 Complete with a Short Block 


Byte 2 - Error Status 


Byte 3 - 


OPCODES 
8008 
e0lée 
4028 
e038 
4048 
05a 
068 
e07é@ 
e086 
409e 
@0Ae 
a0Be 


@0C@ = No Error 
@01@ - Not Ready Error 
@02@ - Parity Error 
@03@ - Tape Hard Error 
@04@ = Attempt to Backspace over BOT 
@05@ - Data Error 
@06@ - Attempt to Backspace over Tape Mark 
@07@ - Device Timeout 
@08@ - Attempt to Write to Write Disable Tape 
@09@ - Gap Timeout 
@0A@ - Service Late Error 
Retry Count 
~ Read 
- Write 


Write Tape Mark 

Skip to Tape Mark 

Read to Tape Mark 
Back Space One Record 
Skip One Record 
Rewind With Walt 
Rewind NC Wait 

Fixed Length Erase 
Backspace TC Tape Mark 
Stream Dump 


Device Dependent Parameters 


Bytes 0,1 - Amount of Bytes short If a Read Encounters a 
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short block. 
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aed aaaRKRKAKKEE 


VIRTUAL MEMORY 
AREER ARA ARRAS 


KAAKARAREKRARER 


CA PROG NAMTAG 
KaaARKAKRAKRKEAAE 


COPY ON BACKING STORE 


kak hh KAKKKAA ABAR 


COPY IN MEMORY 
keh £h 22 BRED 


PACKIO 
ekenbaE 


PACKID 


RERKARE 


0000000 


FILENAME 
KRAKERAL 
FILENAME 
abkeaaae 
SYS-SUPERUTL 


Figure 7-1. DALPROG_NAMTAB 


Pee eR ee ese Se Ee Se 


DA INTERP NAMTAB 


KARA RAREKKEE 


COPY ON BACKING STORE 
keke Re KARKRAH LARK 


COPY IN MEMORY 


RAD RE KKKERE 


PACKID 

dah hah 
oco0000 
0000000 
PACKID 

RaRARAD 
0000000 
0000000 


FILENAME 
AaAKRARE 
SYSMPLII 
SYSCOBOL 
FILENAME 
RRKARHHR 
SYSMPLII 
SYSCOBOL 


Figure 7-2. DA_INTERP_NAMTAB 


KKKKKAKRAKKKKKEK 


DA MISC NAMTAB 


KAKARKAKKRAAHER 


COPY ON BACKING STORE 


RAG Khe RkaKKKER KAKA 


COPY IN MEMORY 


ahhh 2H KAREKE 


PACKID 

eka een 
0000000 
0000000 
0000000 
PACKID 

RazRRAKE 
aqoo0000u 
co000000 
0000000 
co00005 


FILENARE 

Pe eee ee oy 
SYSLANGUAGE 
SY¥S-LOG-02 
SYS-LOG-03 
FILENAME 
RRaRERES 
SYSLANGUAGE 
SYS-LOG-—O1 
SYS-L06-02 
SYSDMFILEQO 


Figure 7-3. DA_MISC_NAMTAB 
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ENTRY-NURBER 
RAgRHADARR EA 
ENTRY-NUABER 
RARRKERBERER 


eT 8) 


ENTRY-NUMBER 
Ae RREEARARR 
o0 
01 
ENTRY-NUMBER 
AHRRAR RRA AR 
00 
01 


ENTRY-NUMBER 
aR RRRARARKED 
00 
02 
03 
ENTRY—-NUMBER 
Seeetestaaak 
00 
01 
02 
03 
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waa karare 


MIX TABLE 
RARaKKKAEE 


COPY ON BACKING STORE 
Adak wh ADAKADR RATE 
MAX JOBS 

NULL MIX RUNNING 

JOB COUNT 

MCS COUNT 

FEMPORARY 10 

NEXT MIX NUMBER 

COUNT WAIT JOBS 
RESTART ID 
INTERPRETER ARRAY O 
INTERPRETER ARRAY 1 
SUPER FUNCTION 


COPY IN MEMORY 

kaaR AR Khe AR 

MAX JOBS 

NULL MIX RUNNENG 
JOB COUNT 

MCS COUNT 

FEMPORARY ID 

NEXT MIX NUMBER 
CGUNT WAIT JOBS 
RESTART ID 
INTERPRETER ARRAY O 
INTERPRETER ARRAY 1 
SUPER FUNCTION 


FF 
FF 
FF 
FF 
FF 
FF 
FF 
FF 
FFEE 
FFEF 


1A 
00 
01 
00 
oc 
Oo 
00 
0e 
0301 
0306 


Figure 7-4. Mix Table - Copy on Backing Store 


MIX TABLE ENTRY / TASK ID 00 
PROGRAM FIB Id 0100 
VA FIB ID 0400 
INTERPRETER FIB ID 0300 
MIX NUMBER 01 
MIX FLAGS 0000 
MIX FLAGS2 00 
MIX STATE 04 
MIX PROCESSOR 02 
MIX INTERPRETER ot 
MIX PRIORITY c2 
MIX TCB SIZE 7FQ2 
MIX PARENT POINTER O00 
REAL STORE oO000 
SPO SIZE O0OU 


OO0GO0DU/SYS-SUPERUTL 


OQUUOGOO/SYSMPLII 


EXECUTING 


PRIORITY 8B 


Figure 7-5. Mix Table - Copy in Memory 


CAN OPEN ANYTHING 


7-11 


CI-L 


kaka ERK 


PORT-TABLE 
kAan KAR aEES 


ENTRY 
eek 
co0e 
ao01 
oode 
0003 
0004 
9005 
0006 
0007 
oogs 
0009 
OOOA 
oooB 
oooc 
gogo 
OOOE 


INDEX 
ah ahe 


USER ACTION 


DEVICES COUNT TYPE 
AQteeee BARAK READE 


uo ga 00 

06 oo O03 DA OP CONTROL 
oo 00 oo 

ao og oo 

01 00 36 DA LP CNERL 
oo 00 aa 

00 uo oo 

04 00 73 DA MT CNTRL 
oo oo 00 

oo 00 00 

00 oo 00 

00 00 oo 

oo oo G6 

og uo aa 

oo 00 oo 


Figure 7-6. Port Table 


AM ACTION.LIST 
INDEX 
RRRARRARHERADS 
FF 

03 


SLPsIIl 


etek 


RERKRAARARA REAR 


PERIPHERAL TABLE PHT 
REAR AR ER 


NUMSER PERIPHERAL LOCKS 
SYSMEM FLAGS 

TASK BYTES 

LOCK BYTES 


ENTRY/DA CT INDEX 
FORCE STATE STATUS 
STATUS 

UNIT/PORT TABLE INDEX 
QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 


ENTRY/DA CT INDEX 
FORCE STATE STATUS 
STATUS 

UNIT/PCRT TABLE INDEX 
QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 


ENTRY/DA CT INDEX 
FORCE STATE STATUS 
STATUS 

UNIT/PORT TABLE INDEX 
QUEUE HEAD 

QUEVE TAIL 

QUEUE CURRENT 


ENTRY/DA CT INDEX 
FORCE STATE STATUS 
STATUS 

UNIT/PORT TABLE INDEX 
QUEUE HEAD 

QUEUE TAIL 

QUEUE CURRENT 


ENTRY/DA CT INDEX 
FCRCE STATE STATUS 
STATUS 

UNIT/PORT TABLE INDEX 
QUEUE HEAD 

QUEVE TAIL 

QUEUE CURRENT 


QUEUE STATUS 

AMLACTIONWLIST ENDEX 

RETURN STATUS 

FORWARD LINK 

BACKWARD LINK 

OP CODE 

BUFFER ADDRESS 

SIZE PARAMETER 

DEVICE DEPENDENT PARAMETERS 


OA 

Gogo 
ucGu 
0006 
00G0 


co 
90 
00 
oF 
FREE 
FREE 
FREE 


o1 
co 
00 
03 
FREE 
FEEE 
FREE 


02 
00 
oo 
a4 
FREE 
trRE 
FREE 


03 
00 
ou 
04 
FREE 
FREE 
FREE 


04 
01 
04 
05 
0001 
oo0t 
oo0t 


01 
18 
0100 
FREE 
FEF 
01 
FIFE 
FIFE 
0243 


coud vooo 
0oOU0 OQuiuv 
Gouo uvGo 
QGuG G300 


FREE 
FREE 
FREE 


tFFF 
FFEF 
FREE 


FREE 
FERF 
FFEF 


FREE 
FREE 
FEFE 


25a8 
25ak 
25h8 


oo 
FREF 
FREF 


0001 O0U00 


OMGu 
o00u 
uGuc 
GOOG 


Uduu 
oouo 
OoOL GBLUO UbOC GOGO 9000 OLGG OGIO 0000 


DEVICE PHYSICALLY NOT READY 


OEVICE PHYSICALLY NOT READY 


DEVICE PHYSICALLY NOT READY 


DEVICE PHYSICALLY NOT READY 


DEVECE PHYSICALLY READY 


COMMAND COMPLETE NO EKROR 


WRITE 


beu2 OUOS FFEF FF 


Figure 7-7. Peripheral Table 


a0cG0 oO0o GCOO 


000u 


SECTION 8 
OPERATING SYSTEM 


INTRODUCTION 


The Operating System section of the dump examines the structures within the MCP. This portion of 
the dump file provides a history of what the MCP was doing before the dump was taken, and shows 
what section of the MCP (if any) detected an error. 


The Operating System portion of the dump file is subdivided into the following sections: 


ACTIVITIES 

AM.ACTION.LIST 

AM.QUEUE.HEAD 

SEGMENT TABLE 

HISTORY COMMUNICATE TABLE 

PI DATA 

DEVICE CONFIGURATION TABLE (DA_CT) 
WB.LB.HEAD - Work Block/Link Block Head 

FIB - File Information Block 

AVAILABLE TABLE - Available Table Map 
OVERLAYABLE MEMORY - Overlayable Memory Map 
AVAILABLE MEMORIES - Available Memory Map 
ODT DATA SEGMENT 


INITIAL DUMP ANALYSIS 


In an initial analysis of the OS section of the dump, these are the sections to be considered: 


ACTIVITIES 

AM.ACTION.LIST 

HISTORY COMMUNICATE TABLE 
PI DATA 

DA_CT 


The remaining sections are explained in the order in which they appear in the dump. 


ACTIVITIES 


This is the area in which the processor register values are saved when a failure is detected. If a clear- 
start occurs, the clearstart number appears in the ERROR NUMBER field. (Refer to Appendix A for 
an explanation of these error numbers.) This information gives a general idea of what caused the clear- 
Start. 


The fields ACTION ID and ACTION NAME contain the ID and the name of the action that is in 
error. If these fields contain @FF@ and the other register values are @00@, then the OS processor 
did not detect an error and therefore was not the reason for the dump to occur. 


NOTE 
If an action was marked ‘‘IN ERROR,” it does not necessarily mean that 
this action had failed. It may mean, instead, that this was the action that de- 
tected the error. For example, this action may have picked up bad data from 
some other area of the MCP, or read an area of corrupted memory. 
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The MAX register is the next entry to be checked. This register is explained further in figure 8-1. It 
contains the bus address and the page of the processor that the OS processor was accessing at the time 
of the failure. If the OS processor detects a memory error, that error may be in any of the processors 
attached to the system. This is because any processor can access any other processor via the Processor 
Interface Bus. 


The IC Status Word fields should be interrogated next. These words identify the status of the processor 
and the type of failure which occurred. Refer to the IC Memory Map, figure 8-2. 


The IC FIRST ERROR REGISTER identifies the memory address within a page of memory that the 
processor was addressing at the time of the failure. In the case of a memory parity error, this register 
contains the address of the failing memory. 


AM.ACTION.LIST 


This area interprets the status blocks of all the actions that were active prior to the dump being taken. 
If the problem was a clearstart, the ACTION ID and the ACTION NAME found in the STATE SAVE 
AREA identifies the action in error. The status block of this action contains pertinent information. 
More specifically, the Caller Field within the status block contains the action number of the action 
that invoked it. This may help to identify the reason for the failure. 


The LINK! and LINK2 fields identify the sequence of events leading up to the clearstart. 


The last field to interpret in the initial analysis of this section is the TASK ID/MIX TABLE INDEX. 
This field identifies the task in the MIX Table on whose behalf the action was running. A @20@ in 
this field indicates that the action was invoked by a system resource. 


HISTORY COMMUNICATE TABLE 


This table identifies the last 10 communicates performed. The table is cyclic, the highest entry number 
is the item which occurred most recently. 


This information is useful as it indicates the type of I/O the system was performing before the clear- 
start occurred. 


For example, if heavy disk I/O had been occurring, it is possible the failure is in the disk area. 
Pl DATA 


In this section of the dump file, the PI DEAD PROCESSORS field indicates any ‘‘dead’’ processors 
on the system. The field is byte-reversed and bit-oriented. 


For example, if a task processor on bus address 5 had been frozen for some reason, this field contains 
1000. When this is byte-reversed it becomes 0010, the fifth bit being set. This indicates the processor 
on bus address 5 is frozen. 


DA_CT 

This table provides the logical status of the peripherals on the system. This information is used in con- 
junction with the Peripheral Handling Table to'determine both the physical and logical status of the 
peripherals. 


The other fields in the Operating System portion of the dump file are used for more in-depth analysis 
of errors. The method. of using them is explained in detail in the remainder of this section. 
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Length 


Byte Description In Bytes 
1 Clearstart/TP/DCP/OS Error No. 1 
2 AM ACTION LIST entry No. 1 
3 Action Name in error 1 
4-5 M1 Register 2 
6-7 WR Register 2 
8-9 M2 Register 2 
10-11 B32 Register 2 
12-13 MAX Register 2 
14-15 MXA Register 2 
16-17 MXB Register 2 
18-19 B1FL Reaister 2 
20 BO Register 1 
21 REQ Register 1 
22-29 XY Register 8 
30-35 J,K,L Registers 6 
36 AD Register 1 
37-38 Top of stack (UMR3) 2 
39-40 Top of X stack (UMRX3) 2 
41-42 2nd on stack (UMR4) 2 
43-44 2nd on X stack (UMRX4) 2 
45-46 3rd on stack (UMR5) 2 
47-48 3rd on X stack (UMRX5) 2 
49-50 Bottom of stack (UMR6) 2 
51-52 Bottom of X stack (UMRX6) 2 
53 IC Error Status 1 
54 IC Status 1 1 
55 IC Status 2 1 
56 iC Staius 3 1 
57 IC Status 4 1 
58 IC Status 5 1 
59 MA Lines Least Significant Byte 1 
60 MA Lines Most Significant Byte 1 
61 XMA Lines Least Significant Byte 1 
62 XMA Lines Most Significant Byte 1 
Notes: 


1. 


Task Processor Error Numbets are defined in Appendix B. 
Clearstart Numbers are defined in Appendix A. 

This field will contain a 00 or FF for Task Processor entries. 
The AM ACTION LIST names are listed in table 8-1. 

See figure 8-2. 


4. This field will contain FF on 1 MHz. processors. 
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This field is known as the FIRST ERROR Register. 


Figure 8-1. Format of Processor State Save Area 


Note 


Byte 
Reversed? 


NAME PAGE ADDRESS MSB 7 6 5 4 3 2 


1 
PROC 2ND 0 
AVAIL ERROR F 
2ND ERROR READ WRITE BOUND MEM UATE 
ERROR PARITY | PARITY ERROR LIMIT | mKro | READ | 

LOCAL=1 Ic BUS ADDRESS 
REMOTE ENABLE 


CONTRL 
OF 
PERIPH 1 


ences: FRZ2 REFRESH 1-0 CLEAR CMND 
ree SET FREEZE | FREEZE | FREEZE | FREEZE 
; BUS 
> ee CONTE eee REG 
PA FREEZE 
MA MA MA MA A 
7 6 2 1 
MA A 
10 g 
0 
8 


oO LSB 


IC STATUS 1 


M 
0 
M 
XMA XMA XMA 
2 1 
XMA XMA XMA 
10 9 


PAGE 


SELECT 


PAGE SELECT 


ED2713 


Figure 8-2. IC Memory Map 


ACTIVITIES 
STATE SAVE AREA 


For each processor on a B 900/B 5900 system, there is an area in the dump known as the State Save 
Area. This area is used to store the contents of the NPRO registers and IC registers at the time a 
failure is detected within that processor. For initial dump analysis, this area is one of the most impor- 
tant areas for the purpose of identifying the cause of a failure. The important fields in this area are 
listed in the introduction to this section. 


If no error is detected by a specific processor, the contents of these registers are: OS, DCP, and Disk 
Processor: the first three bytes are @FF@, the register values are 0. Task Processor: the State Save 
Area address is 0, the area is not printed. 


The format of the State Save Area is detailed in figure 8-1. An example of the State Save Area is 
presented in figure 8-3. This information is also contained in the maintenance log file. Refer to 
B 900/ B 5900 F. E. Handbook, form 1127297, for the format of maintenance entries. 


AM.ACTION.LIST 


This structure is a list of status blocks associated with actions awaiting processor time or an external 
event. The information contained in a status block is as follows: 


ENTRY NUMBER This Information Is formulated by the system 
dump analyzer. I{t Is the Index Into the action 
liste This index Into the action list is the 
action Id. 


STATUS BLOCK ADDRESS This Information is formulated by the system 
dump analyzer. It fs the OS memory address of 
the status block. 


COMM AREA This Is the area which Is used to communicate 
Information to other actions. 


TASK 1D 

MIX TABLE INDEX This field contains the task Id of the Job on 
whose behalf this action is executing.  @208 
denotes that the action Is on behalf of a system 
function, not a task function. 


PARAMS This fleld contains the parameters which were 
passed to activity management by the actions If 
the status of this action Is "WAITING REPLY," 
the second byte of this fleld will contain the 
Actlon 10 of the action Invoked by this action. 


TIME This fleld contains the time of day at which the 
action was started (hour, minute, second, 


hundredths). 


NAME This fleld contains the name of the action which 
owns the status blocke Table 8-1 Is a complete 
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RAERKRARHRAAERKAAAAAAAARARKAAAAKARALR 


eeaaee OPERATING SYSTEM ##8 88% 
RAKAKRAAAAKRAAAABRAAAARALARARRAAR 


kaka kkaaneant 


ACTIVITIES 
RRRADR RARER 


8-6 


STATE SAVE AREA 
STATE SAVE AREA ADDRESS 
ERROR NUMBER 
ACTION ID 
ACTION NAME 

Mt 

WR 

m2 

B32 

MAX 

MXA 

MXB 


AD 

TOP OF STACK 

TOP OF XSTACK 

2N0 ON STACK 

Z2ND ON XSTACK 

3RD ON STACK 

3RD ON XSTACK 
BOTTOM OF STACK 
BOTTOM OF XSTACK 
TC - ERROR STATUS 
IC — STATUS WORD 1 
IC — STATUS WORD 2 
IC — STATUS WORD 3 
IC — STATUS WORD 4 
IC -— STATUS WORD 5 
IC - FIRST EkROR REG 


FF 
FREE FEFF 


END OF LIST EXCEEDED 


Figure 8-3. Sample of Beginning of Operating System Portion of a Dump 


AM.ACTION.LIST ENTRIES (Cont.) 


Itst of possible values and the action they 
denote. The analyzer prints the appropriate Id. 


CALLER This field contains the action id (index Into 
AMeACTION-LIST) of the action that Invoked this 
action. @FF@ = Invoked without walt, @00@ = TP 
Invoked. 


SB_STACK OFFSET This fleld contains the offset of the current 
stackframe (see glossary). 


This ts a pointer from beginning of "comm area” 
toa location in the stackframee This may 
elther he ac an offset, or a memory address: 
This may be determined by the value, since 
stackframes are required to be kept small. 
Typically, if the value Is displayed as nnd 
(byte reversed = 00nn) this would be an offset. 
if an action Is In use, or recently used, one 
would see an address. Conventionally, on yleld 
this value would be returned to an offset. 


LINKI This fleld contains the scheduling Jinks That 
Is, the action Id (Index Into AMeACTION-LIST) of 
the next action on the scheduling list. 


LINK2 This field contains the suspension link. 

STATUS This fleld contains the status of the action. 
The possible contents of this fleld are shown 
below. The field Is also Interpreted by 
SYSANALYZER« 


Value Status Value Status 


a00@ = Available 
401@ Waiting reply (waiting @0B@ Walting Conditional Post 


for an Invoked action) (walting for a task processor 
to finish) 
@02@ Waiting critical action @0C@ Lonely waft (waiting to become 
@03@ = Walting YM action the only action running; used 
@04@ = =Walting W reply with "GT MD".) 


a05@ Waiting post (waiting e0De@ = Event walt 
for an action In OS to 


post a reply) 
@06@ Long delayed @0E@ = Walting mailbox 
@07@ Short delayed @0F@ Walting processor (walting for 
an ftnterrupt from a task 
processor )} 
@ceé@ Walting Interrupt @10@ Ready 
aoe $$$ IN ERROR $$$ x@10@ = Invalld 
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Value 
01 
02 
Q3 
04 
05 
06 
07 
08 
09 


OA 


oD 


Action 
AM_VM 
AM_RTC 
DA_DP_CONTROL 
DA_OSVMIO 
DA_ERRLOGG1NG 
MN LOG INIT 
MN_PROC_POLL 
DC_RSLT FN 
DC_LOAD 
DC_EOJ 
JM_RESTART 
AM_SYSTEM_ERR 
MN QUICK LOG 
FUTURE USE 
P1_ SEND 
P]_RECEIVE 
MN_LOG_IR 
JM_EX 
19) 1 ACCEPT 
4 IPDISPLAY 
0 sy SME SSAGE 
Ol AX 
01 REQUESTS 
01_ROUTING 


Ol SYSSTATUS 


Table 8-1. Status Block Action Name Values 


Value 
1A 


1B 


31 


32 


Action 
AM_UN IMPLCOMM 
DA_RD 
DA_AD 
DA_CL 
UNIMP_SCL 
DA OL 
DA PG 
DA_PO 
DA_RY 
DA_SF 
DA_SN 
DA_SV 
DA _RTN DEV ICE 
DA_CMS START 
DA_CMS_RWR ITE 
DA_CMS_READ 
DA_CMS WR iTeE 
DA CMS DELETE 
DA_CMS_STRMIO 
DA_CMS OPEN 
DA CMS CLOSE 
DA_SYSOPEN 
DA_SYS10 
DA_SYSCLOSE 


DA_ADDAREA 


Value 


49 


4A 


Action 
DA_DUMPTOVM 
DA_SY SPRINT 
DA F ILESEND 
DA_LPCNTL 
DA M DK _CNTL 
MN_TRAP_| NIT 
MN_TRACE_ | NIT 
MN_TRACE_STOP 
MN PROC STATS 
MN_SW ITCH 
MN MEM DUMP 
DC_VERB30 
DC_VERB31 
DC_VERB32 
DC_VERB 33 
OC_VERB34 
DC_SPO 
JM_M IXACCESS 
01 SCL_LOGON 
DA_NAME_FIBID 
JM_JOB_RUNN ING 
JM_JOB REMVED 
JM_GO 
JM_PR 


JM_STOP 


Value 


4C 
4D 
4E 
4F 
50 
51 

52 
53 
54 
55 
56 
57 
58 
59 
5A 
5B 
5C 


5D 
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Action 
JM_DS DP 
JM_THRASHING 
JM _DC_JOBREM 
DC_VERB3F 
AM_WA 1T 
DC_JOB LOG 
JM_TP_ERROR 
AMT IMER 
DA_CMS TS TST 
JM_PAUS E 
AM OT 
AM DATE T IME 
DA_RE SA VR 
AM_CMS ERROR 
DA LP A VR 
DA DK A VR 
OA_| CMD_A VR 


DA_HSP_CNTRL 


Table 8-1. Status Block Action Name Values (Cont.) 


Value 
5E 
5F 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 


6A 


6E 


Action 
JM_SUP_ACCEPT 
JM _EOJ 
JM_MIX 
Ol OCI_INT 
ie) 1 ODT OC 1 
DA GE T_DC MEM 
DA_SO 
DA TO 
P | DE AD_PROC 
01 SCL_READQ 
(e) Is GRU N 
01_SCL_LOGOFF 
DAR EDE FR EAD 
DA_RL 
DA_AP 
MN_LOG L GLS 
DA_VF 


DA_MERGE 


Value 


70 


71 


72 


73 


74 


Action 

DA RUF_GEN 

DA DEV STATS 
DC _DCP ERROR 
DA_MT_CNTRL 
DA MT_A VR 

DA CT CNTRIC 
DA _CT_AVR 

DA _CHNG REEL 
JM_SPO_SIZE 
DA_INIT_TRK 
AM_CMPLX WA IT 
DC_TSTE VNT 

Ol TEST sc Q 
P VRE VIVE 
DA_| O LINKER 
MN_HOOKUP 


MN_DUMMY 
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AM.ACTION.LIST ENTRIES (Cont.) 


PROC. WB 


EVENTS 


EVENT TASK 


ATTACHED OWNER 


ATTACHED 1D 


ATTACHED TYPE 


ATTACHED BASE 


SB SPO ID 
SB SPO TAG 


VMREQ 


Pl REQUEST FUNCTION, 
Pl REQUEST PROCESSOR, 
Pl RESPONSE PROCESSOR, 
Pl RESPONSE FUNCTION, 
Pl MIX NUMBER 


P) RESULT, 
PI FLAGS 


This field contains the assoclated processor bus 
address number In the high order digit. 0 means 
It was Invoked at WARMSTART. The number of 
assigned work blocks In the low order digit 
uses bit pattern 1 bit per WB, not binary count. 


Control Information pertaining to the action 
assoctated with the status block. This field Is 
used by activity management. Valid when the 
action fs wafting on an event or when the action 
caused an event. If this field contains é@FFé@, 
the event has occured; If this field contains 
@008@, the event has not yet occured; [f this 
action caused an event, then this field contains 
the event number. 


This field contains the task Id associated with 
the event described In the previous field; but 
it Is only used if action enabled event. 


The owner of the attached data structure. If 
the attached type Is a work block or a data 
block, this Is an action 1D. lf the attached 
type Is a link block, this is an action Ttist 
name « 


The 1D of the attached data structure. 

The type of the attached data structuree This 
is elther a work block (00), a link block (01), 
or a data block (05). 


The memory address of the attached data 
structure. 


Reserved for future use. 
Reserved for future use. 


This field contalns the last virtual memory 
request. Only valid when waiting on VM. 


Original processor request links. More detail 
will be found In 10, Task Processor. 


These are the result areas for Interprocessor 
communicationse More Information can be found 
in section 10, Task Processor. 


AM.ACTION.LIST ENTRIES (Cont.) 


STACK ENTRIES 


SEGMENT NO 


SEGMENT OFFSET 


LAST.L 


NUMBER OF 
PARAMS 


ADDR OF PARAMS 


LOCAL 
VARIABLES 


AM.QUEVE.HEAD 


This structure is an array of queue heads for system resources. 
dump analyzer by queue name and queue contents. 
IDs (index into the AM.ACTION.LIST). An empty 
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AM.-LAST. QUEUE 


AM-WAITINGeHEAD 


AM.NORMAL «HEAD 


AM.LONG.DELAY 


AM.»SHORT.- DELAY 


These flelds are duplicated for additional 
stackframes and If the outer level declares no 
local variables. A sample status block entry Is 
shown In figure 8-4. 


Fleld contalning the segment number within 
the MCP file. Refer to the Segment Table. 


Contains the return address (of fset within 
the segment). 


Contains the location of the calling segment 
number In the stack frame. (Not valid for 
outer level.) 


Contains the number of parameters In use by 
the stack frame. (Not valid for outer level.) 


Contains the address of the parameters In use. 


Local varlables used by the action. The number 
and type are determined by the procedure In use. 


This field glves the memory address of the head 
of the last queue to be serviceds Currently 
(3.04) this address is not Interpreted. 


This fleld is a pointer to a list of actions 
walting to start. The analyzer lists the action 
Ids of all actions currently In the waiting 
list. A single entry of @FF@ In the 
AM-.WAITING-HEAD field signifies that the IIst of 
walting actions is empty. 


This fleld Is a pointer to an action which Its 
the top of a circular list. The analyzer jists 
the whole circle which fs a set of action Ids. 


This fleld is a pointer to actions which have 
been delayed for secondse The analyzer lists 
all such actions. A single entry of éFF@ 
Implies an empty Hist. 


This Is a pointer to a list of actions which 
have been delayed for milliseconds. The 
analyzer lists the Ids of all such actions. A 
single entry of @FF@ implies an empty list. 


The array is decoded by the system 
The queue contents are shown as a list of action 
queue is shown as having a single entry of @FF@. 


C18 


aR ERRAR AREA 


AM.ACTION-LIST 


AARKRAR RRR E 


ENTRY-NUMBER Lore} 
STATUS BLOCK ADDRESS Fal? 
comm 0301 GOCD 0209 <40u 0000 GOGO GouUn 0902 
TASK 1D / MIX TABLE INDEX 20 
PARAMS ©OGU OG 
TIME 1471 50U0 
NAME && MN DUPMY 
CALLER FF 
SBASTACK OFFSET 2718 


LINK1 fF 
LINK2 FF 
status 16 READY 


PROC.WB 20 
EVENTS 60 
EVENT TASK 00 
ATTACHED OWNER 0 
ATTACHED ID FF 
ATTACHED TYPE GO 
ATTACHED BASE OG000 
se spo ID 00 
$B SPO TAG O000 
vmREQ O000 
PI REQUEST FUNCTION 8B 
PI REQUEST PROCESSOR 01 
PI RESPONSE PROCESSOR O02 
Pk RESPONSE FUNCTION FF 
Pl MYX NUMBER 20 
PY RESULT O00 
Pl FLAGS 60 
STACK ENTRIES 
RARaD BARR 
SEGMENT NO OO 
SEGMENT OFFSET 216E 
LAST-L 0625 
NUMBER OF PARAMS UO 
ADDK OF PARAMS 
LOCAL VARIABLES 0000 0000 0000 G000 0000 9000 0000 Good G00 8009 0000 CON OOO OON0C ougg ao00 
000u 0060 0000 GOOD G000 douO GOO COCO 0000 00co0 0000 C000 0000 0000 D000 OOu0 
0000 0000 OC00 0006 0000 COUN LOGO 0000 9000 0600 D000 VOOO OOOG 0000 “Oto 0000 
90G0 0000 


Figure 8-4, Status Block Entry Example 


SEGMENT TABLE 


This structure is an array of code and data block descriptors. The analyzer decodes each descriptor 
of this table for the user. The descriptors indicate the segment’s ID, frozen/jelled count, size, disk ad- 
dress, present/access/type, memory address, and page. 


HISTORY COMMUNICATE TABLE 


This table is a trace of the last ten communicates received by the OS. Each table entry comprises the 


following fields: 


ENTRY This field contains a number incremented by 1. 
Its purpose Is to show the order [In which the 
communicates were received. 


TASK iD This fieid is 


index 
Using this information along with the mix table 
will reveal which job Issued the communicate. 


into the mix Tabdie. 


BUS ADOR This fleld Indicates the processor which was 
running the task that Issued the communicate. 


VERB This parameter Is held In byte 0 of the CPA and 


Is used to 


functions Is required. 


MCP = MANUAL... 


The 


Indicate which of the possible 


it may take values in 
the range 0 = 255. For full details see the CMS 


current list of CMS 


communicates fs given below: 


01 : OPEN 

02 : CLOSE 

110: ZIP 

12 : DISPLAY 

13: ZIP & DISPLAY 
14 : PAUSE 


15: ZIP & PAUSE 

16 : DISPLAY & PAUSE 

17: ZIP, PAUSE & DISPLAY 

1A : CONDITIONAL DISPLAY 

1B : ZIP & CONDITIONAL DISPLAY 
1C : DISPLAY WITHOUT LOGGING 
20 : ACCEPT 

21 =: SUPER.ACCEPT 

30 : MCS CONTROL COMMUNICATE 
31 : MCS INTERROGATES 

32 : MCS REDEFINITION 

33 : USER DATA COMM 

34 : MCS DCP ORIENTED COMMUNICATE 
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50-6F 
10-7F 


DATE-T IME 

TERM I NATE 

WAIT 

SYSTEM STATUS 
RESERVED FOR EXPANSION 
RESERVED FOR SYSTEM UTILITY FUNCTIONS 
TEST STATUS 

READ (NOT CONSOLE) 
WRITE (NOT CONSOLE) 
REWRITE 

DELETE 

STREAM CONTROL 

START 

OVERWR I TE 

READ-WRITE 

READ (CONSOLE ) 

WRITE (CONSOLE) 

GET 

PUT 
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0B JECT 


ADVERB 


This parameter Is held In byte one of the CPA. 
Most commonly, It is an index Into the task®s 
data segment table giving access to data which 
characterizes the entity upon which the function 
Is to be performed. For file type 1/0 
communicates, for Instance, it Is the DST Index 
for the associated fite Information block. 


This parameter, if it exists, consists of a 
varlable number of bytes starting at byte 2, and 
comprising the remainder of the CPA. 


Refer to figure 8-5 for an example of the History Communicate Table. 


Pl DATA 


Refer to figure 8-6 for an example of the PI Data Area. 
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Pl MAILBOX PAGES 


Pl ACTIVE 
INPUT MAILBOXES 


Pl ACTIVE 
OUTPUT MA) LBOXES 


P} DEAD PROCESSORS 


Pl WAITING 
MAILBOX 1DS 


This structure Is an array of constants which Is 
a list of processor numbers. These are listed 
to be used as Jabels for the following arrays, 
active input matiboxes, active output mailboxes 
and walting mailbox ids. 


This array is used by task processors’ to 
Indicate that thelr output malilbox contains a 
message for the OS.- A request is Indicated by 
an @80@ and a response Is Indicated by a @00@. 
@FF@ Is used to denote an Idle maltlboxe The 
array 1s ordered underneath the matlbox pages 
field. 


This array Indicates the outstanding mailbox 
ACKse An acknowledgement is Indicated by a 00. 
The processor related to the acknowledgement can 
be found In the equivatent position In the 
active Input array abovee Again @FF@ Is used to 
denote the Idle state. 


This fleld indicates which processors have gone 
not readye Each bit represents a bus address (1 


relative). 
NOTE 


This field Is byte-reversed. 


This array Indicates actions which are waiting 
for a mailbox acknowledgement. Each byte of 
this array Is an action Id (index Into the 
AM_ACTION LIST)» The index Into this table (0 
relative) Is the processor number assoclated 
with the action. 


SAMAR AR AD AREA HAART ee TASK BUS 


HISTORY COMMUNICATE TABLE ENTRY 1D ADDR VERB OBJECT ADVERB 

RAAAKAADARARARAAARARALARK aaete gees saan saad Ratnaan aananad 
13 oc 04 G2 CeOseE 22 1010 F0G300000C0000000C000000 
14 oc 04 Q2 CLOSE 21 10130F 003000 000000G00u00C0L00 
15 oc 04 41 TERMINATE &0 96001003000 00 GoD0CO00Cc0C0000 
ac ac 04 84 WRITE 21 10 10900300000G000C0000000000 
oe oc 04 82 READ 22 0000597300000000000000000000 
OE oc 04 82 READ 22 00109 F G3000000G000000K0G00000 
OF oc 04 84 WRITE 21 10109 F0 30G0000000UG0c00000000 
10 ac 04 82 READ 22 000C5€7 300000 00000000 0000000 
it 6c 04 &2 READ 22 0010 FUO30000C000000C0 0000000 
42 ac 04 84 sRITE 21 10 70f 06306000000 G00000000000 


Figure 8-5. Example of the History Communicate Table Portion of a Dump 


aaketa 


FI DATA 
ree rrr ye 


PI MAILBOX PAGFS 1102 0504 950€ U7U8 O9OA CeOC ODOE UFFF 
PI ACTIVE INPUT MAILBUXES FREE FREF FREE FFRFE FERE GFF FRRF FREE 
PL ACTIVE OUTPUT MAILAOXES FFEF FFEF FEEF FFF FFRF FEFE FEF FREE 
PT DEAD PROCESSORS COUD 
PL WAITING MAILGOX IPS FFFR FRFF FFEE FREE FFER FREE FORE FREE 
PE FREE MAILGOMES FFEF FEFF FREE FFFF FRER FREER FEEF FF 
PI QUEUE COUNT 03 
Pl INVOKED OG 


Figure 8-6. PI Data Example 


P! DATA (Cont.) 


Pl] FREE MAILBOXES This Is an array of flags Indicating If the 
maltbox for a processor [s avallable. (@FF@ 
indicates available.) 
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DA_CT (CONFIGURATION TABLE) 


This table contains one entry per device. This information is used by data access when performing 
opens, OLs and other SCL commands. Each entry of the table contains the following fields: 


ENTRY/PHT INDEX This fleld Is an Index Into the peripherai 
table. 
CMS DEVICE TYPE This fleld contalns the device type, such 


as BSM cartridges The analyzer Interprets 
this fleld into both SPO mnemonic and 
English name. 


TASK ID This fleld Indicates the task Id (Index 
Into the AM-ACTION-LIST). @FF@ In this 
fteld means that no action is currently 
associated with this entry; It Is only 
valid during Job load, when It contains 
task Id of Job being loaded. 


FILE OPEN This fleld contains the number of files 
open on the device. 


STATUS This fleld Indicates the logical status of 
the devicee This Is a 2-byte field, the 
second of which Is not used. The following 
is a decode of this fleld as shown by the 
system dump analyzer. 


MSB 7 - Reserved 
Multifite 
Purged 

Untabel led 
System 

SV or PO pending 
Assigned 

LSB O —- Ready 


aman WwW PUA 
' 


SPO MNEMON IC This fleld contains the assoclated mnemonic 
for thls device (DMA, DKB, etc-). 


FILE ID For a disk device, this fleld contains the 
(pack id). For a tine printer, it fs 
(fileld) If a file Is currently open on the 


printer. 
SERIAL NUMBER thru These flelds contain label information 
LOG UNIT found on the device. 


Refer to figure 8-7 for an example of a DA _CT entry. 


RARER ERAMAAKEAAAKAD AA KAKA AALR 


DEVICE CONFIGURATION TABLE OCA-CT 
Pee Pee eee oe ee ee eee eer ero rTes ee es 


ENTRY/PHF INDEX 
CMS DEVICE FYPE 
TASK ID 

FILE OFEN 

STATUS 

SPQ MNEMONIC 

FILE ID 
ALLOCATION UNIT 
PACK TAG/LOG UNIT 
SECTORS/TRACK 


ENTRY/PHT INDEX 
CMS OEVICE TYPE 
TASK 1D 

FILE OPEN 

STATUS 

SPO MNEMONIC 

FILE 10 
ALLOCATION UNIT 
PACK TAG/LOG UNIT 
SECTORS/TRACK 


ENTRY/PHT INDEX 
CMS DEVICE TYFE 
TASK ID 

FILE OPEN 
STATUS 

SPO MNEMONIC 
FILe 10 

SERTAL NUMBER 
ALLOCATION UNIT 
PACK TAG/LOG UNIT 
SECTORS/TRACK 


Figure 8-7. Sample DA_CT Dump File Entry 


WB.LB.HEAD 


ocoa 
cE 
FF 
o0oc 
4000 
OMA 


FF 
20 
38 


0007 
CE 
FF 
0000 
400G 
OMB 


FF 
20 
3B 


0002 
ce 
FF 
0000 
4000 
OKC 


723456 
01 
20 
20 


OM-3/6 MINI 


MULTI-FILE 


DOM-3/6 MINI 


MULTI-FILE 


OK~—CARTRIOGE 


MUL TI-FILE 


This field is a pointer to a linked list of work and link blocks currently allocated. The analyzer decodes 
each entry on the list and breaks out the descriptor address and type, and the size, link, type, address 


and owner of the work or link block. 
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FIB 


OWNER The owner from the WB.LB-HEAD of DA_TASKnan LIST 
using thls FIB. DA TASK LIST will Indicate the 
user task. 

ID Segment number of the FIB- 

FILE STATE The values In this fleld reflect the open/close 


state of the file as follows: 


@008@ = half closed - new file 
@01@ = half closed - old file 
@02@ = open - new file 
@03@ = open - ofd file 
@04@ = belng opened 
@05@ = half closed - printer backup file 
COMM JN PROGRESS A flag Indicating If a communicate Is currently 


In progress using this F1B (Flag = 1 Indicates 
tn progress) 


FILE TAG INFO MSB 7 : Extended file 
6 : Overflow fife 
(exists on more than one pack) 


5-0 : Configuration table of fset 


FILE TAG DIRECTORY For multipte-pack fibes, this fleld contains a 
potnter to the disk fille header (DFH); this DFH 
wibb point to the next pack. 


FILE TAG PACKTAG Pseudo pack tag appended to the original file 
name by pseudo pack impiementaTion. 


FILE USAGE This Is a bit map. 


MSB 7-5 : value 001 = normal/shared 
111 = locked 
3: value 001 = shared 
3 : value 001 = locked 
2-0 : value 001 = normal/shared user 
111 = locked user 


FT ADDRESS PAGE Memory page on which the associated file 
resides. 
FT ADORESS BUS Memory address of the assoclated fite table. 


Other fields are considered self-explanatory. Refer to figure 8-8 for an example of the FIB entry. 
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the 


FIB 

nea 

KEY USAGE 

KEY f1LE TAS 
KEY FILE SUfFER 


JPDATED 

KEY FILE TABLE ADDRESS 
KEY FILE TALE ADDVESS 2 
DUPLICATES ALLOWED 
READ STATUS 

KeY OFFSET 

NULL KEY FILE 

ROUGH TASLE IN MEMOQDY 
PRESENT SECTOR 

LAST ACCESS 

CURRENT AREA 4 
CUPRENT SECTOR 1 
CURRENT DFFSET 1 
CURRENT &RN 4 

CURRENT AREA 2 
CURRENT SECTOR 2 
CURRENT OFFSET 2 
CURIENT RAN 2 

CURDENT KEY 


ENTRY SIZE 
TABLE SIZE 
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OWNER O05 
1d) 12 
FILE STATE 03 
COMM IN PROGRESS 00 
FILE TAG INFO 84 
FILE TAG DIRECTORY 7500 
FILE TAG PACKTAG 20 
FILE USAGE 20 
ORGANIZATION 02 
ACCESS 01 
MYUSE OT 
CMS DEVICE TYPE ¢3 
FPB SEGMENT NUMBER O08 
FPB SIZE SEOD 
OTHERUSE 03 
LAST COMMUNICATE 8&2 
RECORDS/BLOCK 0100 
RECORD SIZE 8400 
WORK AREA SEGMENT 00 
WORK AREA OFFSET 4605 
WORK AREA LENGTH 8400 
MAX WRITTEN OO00T A8& 
MAX POSSIBLE 00014 A8 
CURRENT RECORD O000 81 
CUR REC INVALID 00 
CURRENT BLOCK O00G 80 
SECTORS/BLOCK 0100 
BLOCK COUNT 0000 
BACKUP RECORD BUFFER QOUG 00 
MAX NUMBER BUFFERS 01 
NUMBER BUFFERS ALLOCATED 01 
BYTES/BUFFER 8400 
OFFSET WITHEN RECORD 0000 
RECORD WITHIN BLOCK 0000 
DYNAMIC ACCESS 00 
EOF FLAG O00 
‘OUTPUT ALLOWED FF 
SPARE CHARACTERS G000 
TRANSLATION NEEDED O00 
MS OPEN OO 
ORG DEVICE 39 
FLAGS 00 
PB FILE NUMBER 39 
SUFFER AHEAD NUMBER FFEF FF 
FILE TD 5359 534C 416E 
PB LP DEVICE TYPE 43 
FT ADDRESS PAGE 0007 
FT ADDRESS BUS 7DAS 
0024 
30346 3790 O1CF 3030 3034 3709 0100 3030 
3934 3709 2193 3030 7934 3705 9104 3030 
3034 3899 0107 3030 3034 3390 O1D8 3039 
3934 3200 0198 3039 3034 3800 O1DC 3030 
3934 3890 O1DF 3036 3034 333C 0169 3039 
3934 3909 51E3 3030 3034 3903 O14 1397 
FQD3 
2007 
64 
$4 
ER 
64 
33 


4755 


3034 
3034 
3036 
3034 
3034 
9057 


OPEN Otb 


SEQUENTIAL 


OK-ANY DISK 


4147 4520 


3790 9101 
2739 9105 
3890 0109 
3859 0100 
3990 9151 


3039 
3939 
3030 
3030 
3039 


3234 
TI34 
3034 
3034 
3934 


3796 
IAN 
mers) 


3200 
3390 
3990 


J1o2 
2106 
D1DA 
DIDE 
O1€2 


3034 39FF FREFF FRFFF FREE FREES FREE FREER FRFEF FREE FERF FERRE FREER FREER FERRE 


FFRE FREE FREER FRFFE FPRFE FREE 

02 

NUMER SECTOR OFFSET KEY ENTRY 

exert kek keh thee kkk keke 
0330 3030303530 
0000 FRE FRRRFFE 


FRER FRRF FRFF FREE FFFF 


Figure 8-8. File Information Block Example 
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ODT DATA SEGMENT 


The fields of this portion of the formatted dump file are explained in the following list. A sample 
of this section is shown in figure 8-9. 


SYSCONF IG Twenty bytes which contaln ZIP text taken from the 
ZIP TEXT SYSCONF IG file. 


REMOTE TASK One byte which contains the task ID of the program fogged 
1D on as remote SPO. 


CONTROLLING Not used. 
SPO 1D 


CONTROLLING Not used. 
SPO TAG 


SPO ACTIVE This Is a 2-byte fleld; each bit Indicates If the 
ARRAY assoctated task Is a REMOTE SPO operation. 


ODT FLAGS This ts a I-byte fleld. The significance of Its bits 
Ts as follows: 
BIt 7 (MSB) ODT In shutdown mode 


Bit 6 Remote SPO Is al lowed 

Bit 5 Processing PO message 

Bit 4 Ol routine In shutdown 

Bits 2 & 3 Not used 

Bit 1 A remote SPO exists 

BIt 0 Loca! SPO in use 
ACTIVITY This 1s a one-byte field. The significance of each bit 
FLAGS is as follows: 

BIt 7 (MSB) O! START complete 

Bit 6 Ol SYSMESSAGE down 

BIt 5 Not used 


Bits 3 & 4 00 - No local SPO exists 
Ot - Local SPO exists 


Bit 2 SYSIO buffer WB exists 
Bit 1 Dictionary ts open by Ol 
Bit 0 SYSCONF IG is open by Ol 


DICTIONARY This Ts the FIB 1D of the dictionary file. 
FIB ID 


SYS1O WB ID This Is the ID of the work block being used for SYSI0. 


ROUTING This is the ID of the link block entry at the head of 
LIST HEAD the routing list. 


ROUT ING This ts the ID of the link block entry at the tall of the 
LIST TAIL routing list. 


SPO QUEUE This ts the ID of the link block entry at the head of 
HEAD the SPO queuee This Is a holding area for messages. 
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SE RRRKRHERHH NRE 


GOT DATA SEGMENT 
SA UN BAR NNR 


SYSCONFIG ZIP TEXT FFFF 
REMOTE TAsK iD FF 
CONTROLLING sPO ID FF 
CONTROLLING SPO TaG FF 
SPU ACTIVE ARRAY 0000 
ODOT FLAGS 41 
ACTIVITY FLAGS aa 
DICTIONARY FIB i0. 0200 
SYS10 WB iD) On 
ROUTING LIST HEAD 98 
ROUTING LIST TAIL 98 
ODOT LIST HEAD ya 
OOF LIST TALL 98 
3P0 QUEUE HEAD 4a 
SCL QUEUES HEADS gu00 
sPO QUEUE TAIL Ou 
SCL QUEUES TAILS 4000 
RUUTENG POST 10 16 
OT POST ID FF 
S@0 CHANNEL ID 43 
LUNG MSG INDEX 0700 
ADORESS UF MSE OUT 55C5 
MSG OUT DAFA wo000 
MoG IN 4130 
FEFF 
FFFF 
FFFF 
FRFF 
FFFF 
FRFF 
FREE 
FRFF 
CONSOLIDATED sTATUS 40 
TRANSMIT STATUS 40 
RECEIVE status v0 
OCL FLAGS Qe 
PROC FLAGS. ao 
RECEIVE CHAN 15 
OCI TRANSHIT ID 19 
CHARACTER COUNT 40 
TAMER VALUE 0007 
MESSAGE TYPE 60 
Ms& OUT LENGTH 1€C00 
MSG OUT INDEX 0700 
MSG IN INDEX 0300 
MSG IN LENGTH 1000 
MSG IN &™B OID FF 
SENO PROGRESS Ou _ 
TERMINAL SEQUENCE 1411 
HEADER SEWUENCE 0141 
LINEFEED SEQUENCE 1822 
ERROR SEQUENCE 0141 
CLEAR & SCROLL 0141 
1853 
Figure 
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FFFF 


a000 


a00u 


0008 
a244 
FFFF 
FFFE 
FFFF 
FFFF 
FFF 
FFFF 
FFFF 
FF 


0301 
3002 
2024 
3002 
3002 
1843 


8-9. 


FEFE FREF FRFE FERFE FREER OFFEE FEFF OFFFF 


REMOTE SrO ALLOWED 
LOCAL SPO IN USE 


UL START COMPLETE 
LUCAL SPU EXISTS 


GICTIONARY IS OPEN BY OF 


0000 O0U0 v000 0000 0000 Ovud Qu00 vooD 


0000 0000 0vd0 yv0Od 0000 Ovaood vooO yoon 


ovo 
2F4a4 
FFFE 
FFFF 
FFFF 
FFFF 
FFF 
FFF 
FFF 


vooo 
3903 
FFFF 
FRFF 
FFFF 
FFFF 
FFFE 
FFFF 
FFFE 


0ou0 
5320 
FFEF 
FFFF 
FREE 
FFFF 
FREE 
FFFF 
FFFF 


0000 
3033 
FFFF 
FFFF 
FREE 
FFFF 
FFFF 
FREE 
FFEF 


oooo 
554) 
FFFF 
FFFF 
FFFF 
FFFF 
FFFE 
FFFF 
FFFF 


Oouo 
4059 
FFFF 
FFFF 
FFFF 
FFFF 
FFF 
FFFF 
FFFF 


0000 
2E32 
FFFF 
FFEF 
FFFF 
FFEE 
FFEF 
FEFF 
FREE 


auoo 
3130 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 


RECEIVE REQUEST 


TRANSMIT UNDERVAY 


1840. 1822 
1822 2F23 
1Bé2 3020 
1853 1848 


2u37 2020 20 
1848 1822 6823 3045 5252 3E 


1853 1848 1853 1848 


Sample ODT Data Segment 


0000 


00u0 


oo0u0 
FFFF 
FFFF 
FFFE 
FFFF 
FFFF 
FFFF 
FFFE 
FEF 


oou0 


Ouvd 
FFFF 
FFFF 
FFFF 
FFFF 
FFEF 
FFFF 
FFEF 
FFF 


ou00 


0u00 
FFFF 
FFFF 
FFFF 
FFFE 
FFFF 
FFFF 
FFFE 
FEFF 


oo00 
FFFEF 
FFFE 
FRFF 
FFFF 
FFFE 
FFFF 
FFE 
FFFE 


600u 


FFFE 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 
FFFF 


FFFF 
FFFF 
FFFF 
FFEF 
FFFF 
FREE 
FFFF 
FFFF 


1848 1B22 2021 184B 1822 2022 1843 i822 2023 1948 1822 2023 
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SPO QUEUE This Is the ID of the link block entry at the tail of 
TAIL the SPO queue. 


SCL QUEUES Not used. 


TAILS 

ROUT ING This is the ID of the status block that is handling 
POST ID message routing. 

ODT POST This Is the 1D of the status block that is handling ODT 
1D output messages. It Is used by the routing action. 


SPO CHANNEL This Is the physical channel for the ODT device. 
ID 


LONG MSG This 1s the Index Into output messages that are longer 
INDEX than one screen. 


ADDRESS OF This Is a 2-byte address of the message being sent 
MESSAGE OUT to the ODT. 


MSG IN Input message from the ODT. 


CONSOLIDATED This Is a I-byte fleld. The sIgnificance of the bits 


STATUS Is: 
Bit 7 (MSB) Transmit request 
Bit 6 Recelve request 
Bit 5 Timer A request 
Bit 4 Timer B request 
Bit 1,2,3 Not used 
BIt 0 Recelve error 


TRANSMIT ODT DC! status for Transmit state. 


STATUS 
RECEIVE ODT DCI hard status for Receive state. 
STATUS 
DCI FLAGS This ts a I-byte fleld. The significance of the bits 
Ts: 
Bit 7 (MSB) DCI Is finished 
Bits 4,5,6 Not used 
Bit 3 Transmit inside recelve 
Bit 2 Transmit desired 
Bit 1 Transmit underway 
Bit 0 Receive underway 
PROC FLAGS This Is a I-byte fleld. The significance of the bits 
Ts: 
Bit 7 (MSB) An error was logged 
Bits 5,6 Not used 
Bit 4 Explicit line feed 
Bits 1,2,3 Not used 
Bit 0 Error In message 
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RECEIVE 
CHAR 


DC! 
TRANSMIT 
1D 


CHARACTER 
COUNT 


TIMER VALLE 


MESSAGE 
TYPE 


MSG OUT 
Length 


MSG OUT 
INDEX 


MSG IN 
INDEX 


MSG IN 
Length 


MSG IN WB 
ID 


SEND 
PROGRESS 


TERM I NAL 
SEQUENCE 


HEADER 
SEQUENCE 


LINEFEED 
SEQUENCE 


ERROR 
SEQUE NCE 


CLEAR & 
SCROLL 
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This Is the last character recelved from the OOT. 


This Is the 1D of the status block that Is handling OOT 
output messges- This Information Is used by ODT DCI 
Interrupt action. 


This Is the count of the number of characters recelved 
from the ODT. 


This Is a value used to prime a hard timer In the OOT 
DCI. 


This Is a value used to Indicate various Internal 
message types; for example system messages or ODT 


ee es a 
CONMIGO! MESSagese 


This Ts the length of the OOT output message In bytes. 


Index to the current character belng output to the OOT. 


Index to the current character belng [Input from the ODT. 


This Is the length of the ODT message In bytes. 


This is the ID of the work block where the incaning ODT 


message Is belng placed. 


This Is an Internal value used to step through the 
transmission sequence. 


Each of these sequences Is a serles of contro! characters 
used by the ODT controller to manipulate the ODT screen 
under varlous circumstances. 
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SECTION 9 
DATA COMMUNICATIONS 


INTRODUCTION 


The data communications portion of a system dump is divided into three sections. Each section repre- 
sents one of the major parts of the B 900/CP 9500 Data Comm (DC) Subsystem. These sections are: 


DCA MEMORY (Data Comm Activity Memory) 
DCP MEMORY (Data Comm Processor Memory) 
BUFFER MEMORY 


This section examines these three parts in detail. They are discussed in the order in which they appear 
in a printed dump file. 


DCA MEMORY 


DCA memory is part of OS MEMORY and is maintained by the MCP. This area is divided into two 
subsections. Both subsections reside in OS MEMORY but they are managed differently. 


The first and most important area of DCA MEMORY is the resident data segment. This segment of 
memory forms the nucleus of the DC subsystem. It maintains an address directory for tables located 
in Buffer Memory (BM) and Virtual Memory (VM), and for various other size values and fields neces- 
sary to maintain the DC subsystem. 


The second area of DCA MEMORY is part of VM, and contains the tables responsible for driving 
the DC subsystem. The information in these tables is extracted from the NDLSYS file at the time the 
Message Control System is loaded. 


RESIDENT DCA MEMORY 


A list and description of the DCA MEMORY fields resident in OS MEMORY follows. These items 
are discussed in the order in which they appear in the printed dump. The contents of the 2-byte fields 
are printed in byte-reversed order. 


NOTE 

In reading a printed dump, it is very important to understand the limits and 
basic operation of Virtual Memory. Table 9-1 gives the Data Comm tables 
which are maintained in VM. At the time a dump is taken, the contents of 
these tables may be in memory or they may be ‘‘swapped out’’ and located 
in disk memory (referred to as backing store). Any table or field may yield 
its space to another user. The VM algorithm determines which tables and 
fields are swapped out. If a table or field is in backing store when a dump 
is taken, the dump gives the address in resident memory at which it was last 
located. It is particularly important to keep this concept in mind if a Hex 
dump becomes necessary. 
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RESERVED 


MCS LOADED 


DCP LIMIT 


BUFFER SIZE 


STATION COUNT 


USER DC LOGS 


Table 9-1. DC Subsystem Table in Virtual Memory 


USER JOB table 10 =1 
MCS table ID =2 
LSNTAB table ID = 3 
LLNTAB table ID =4 
SUBTAB table D=5 
NOL table ID = 6 
DCP table ID=7 
DCPOON table ID =8 
LSN INFO table ID=9 
MCS NAME table ID=A 


This I-byte fleld Is reserved for special use. 
At the present time, this fleld Is set to 1 If a 
DC-RECONFIG has been used since the loading of 
the DOC subsystem. 


Binary count of the number of Message Control! 
Systems (MCSs) physical ly loaded. 


This 2-byte field contains the highest logical 
DCP number (defined In NOL). 


This 2-byte field Is the slze (In bytes) of the 
Data Comm Buffer as determined in the OCP 
SECTION of the NDL. It Is Incremented by 4 when 
the DATA COMM LOAD ACTION is performed. 


This I-byte fleld contains the total number of 
stations defined in the NDL.~ Both real and 
dummy stations are Included In this count. 


This Is a 4-byte fleld broken out In the dump 
listing as two 2-byte fields, USER DC LOG! and 
USER DC LOG2. Together these two flelds make up 
a 32-bit field, each bit representing one of the 
32 possible (maximum) TASK IDs (user Jobs). 


NOTE 


Only 26 Jobs are supported by the 3.04 MCP. 
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SUBNET COUNT 


LINE COUNT 


DC €OJ ACTION ID 


LFN BLOCK SIZE 


LSN BLOCK SIZE 


XLSN BLOCK SIZE 


USER JOB LAST ADDRESS 


When a user job Is executed and goes to BOJ, the 
appropriate bit Is set; the bit Is reset when 
the Job ends (DS, DP, or EOQJ). The format for 
these fields Is as follows: 


USER DC LOG! Byte 1 (bits 7-0) 
Byte 2 (bits 15-8) 
USER DC LOG2 Byte 3 (bits 23-16) 
Byte 4 (bits 31-24) 


This i-byte fietd contains the total number of 
subnet queues which are defined In the FILE 
SECTION of the NDL. 


This 1-byte fleld contalns the total number of 
IInes which are defined In the NDL. 


This” -byte field Is Inittallzed to @FF@ 
when the DC.LOAD-ACTION.ID Is performed during 
the loading of the DC subsystem. This fleld 
holds the ACTION.ID If and when the DC.EOJ 
action Is suspended. Suspension of the ODC.EOJ 
action occurs when the last MCS Is terminating 
and any one of the COBOL ACTIVE flags of the 
User Job Table Is set. 


A 2-byte field containing the size of the Iink 
blocks used to hold the list of logical file 
names. The list of logical file names can be 
found In the Work Block/Link Block IIst in the 
Operating System section of the dump. 


A 2-byte flefd containing the size of the !Ink 
blocks used to hold the list of Logical Station 
Names. The list of Logical Station Names can be 
found In the Work Block/LInk Block list [In the 
Operating System section of the dump. 


A 2-byte field containing the size of the fink 
blocks used to hold the list of Extended Station 
tables. The Extended Station tables can be found 
in the Work Block/Link Block list In the 
Operating System section of the dump. action ID 
stored In this fleld Is used to reinstate the 
Job. 


This 2-byte fleld is the OS MEMORY ADDRESS at 
which the User Job Table was last located. The 
contents of the User Job Table are described 
later In this section. |f It becomes necessary 
to check the Hex dump, remember that this table 
may have been swapped out, and this address may 
be Invalid. (LINKED BLOCK !D = 1) 
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TASK TO MIX TABLE 


MCS ID TABLE 


MCS TABLE 
LAST ADORESS 


LSN CONVERSION 
LAST ADORESS 


LSN INFO 
LAST ADDRESS 


LINE CONVERSION 
LAST ADDRESS 


SUBNET INFO 
LAST ADORESS 


OCP CONVERSION 
LAST ADORESS 


DCP TABLE 
LAST ADDRESS 


This Is a 32-byte array (one per allowable task 
number) that can be used to find a Job's 
external mix number when Its TASK-ID [Is known. 
The Job's task number Is used as a O-relative 
Index Into the array In order to obtain the mix 
number. This table Is Initlallzed to al! Os. 


This 32-byte array (one byte for each allowable 
task number) can be used to find a _ task's 
relative MCS number when its task number is 
knowns The MCS task number is used as a 0- 
relative Index into the array to obtain the 
relative MCS number. This table Is Inittalized 
to ail @FF@s. 


This 2=-byte fleld is the OS MEMORY ADORESS at 
which the MCS table was tast located. The 
contents of thls table ara described later In 
this section. If it becanes necessary to check 
the Hex dump, it should be ranembered that this 
table is stored in Virtual Memory = and, 
consequently, the Hex address may not be valid. 
(LINKED BLOCK IO = 2) 


This 2-byte fleld is the OS MEMORY ADDRESS at 
which the LSN conversion table (LSNTAB) was last 
located. Tne contents of LSNTAB are described 
later In this section. (LINKED BLOCK ID = 33 


This 2-byte fleld is the OS MEMORY ADDRESS at 
which the LSN INFO table was last located. The 
contents of this table are described later In 
this section. (LINKED BLOCK ID = 9) 


This 2-byte fleld is the OS MEMORY ADORESS at 
which the Logical Line (LLN) Conversion Table 
was tast located. The contents of this table 


are described later In this section. (LINKEO 
BLOCK 1D = 4) 


This 2<byte fleld Is the OS MEMORY ADDRESS at 
which the SUBNET INFO table was tast located. 
The contents of this table are described later 
In this section. (LINKED BLOCK ID = 5) 


This 2-byte fleld shows the last address for the 
DOCPOON Table. (LINKED BLOCK ID = 8) 


This 2-byte fleld shows the last address for the 
DCP Table. The contents of the OCP Table are 
described later In this section. (LINKED BLOCK 
10 = 7) 
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NDL DATA 
LAST ADDRESS 


MCS NAME 
LAST ADDRESS 


ABP ADDRESS 


REQUEST Q ADDRESS 


SUBNET Q ADDRESS 


This 2=byte fleld glves the last OS MEMORY 
ADORESS of the NOL Tabie. The contents of the 
NOL Table are described later In this section. 
(LINKED BLOCK 10 = 6) 


This 2-byte fleld gives the tast OS MEMORY 
ADDRESS at which the MCS NAME table was last 
located. The contents of this table are 
discussed later in thls section. (LINKED BLOCK 
ID = A) 


This 4-byte field ts the of fset, page, and bus 
address of Information about the Avallable 
Buffer Pool. The first two bytes of this field 
contain the offset, the third byte Is the nage 
number, and the last byte Is an address pointing 
to where buf fer pool Information Is stored. 
This second location has a 12-byte fleld divided 
Into five groups: 


Read With Lock Word (RLW) 1 byte: 00 = unlocked 


01 = locked 
Processor ID 1 byte 
Buffer Count 2 bytes 
ABP Head Pointer 4 bytes: page, bus, address 
ABP Tali Polnter 4 bytes: page, bus, address 


The APB TAIL POINTER field Is printed by the 
dump at the beginning of the ABP area In the 
BUFFER section. 


This 4-byte fleld gives three pleces of 
Information. The first two bytes contain the 
offset, the next byte Is the page number, and 
the last byte gives the beginning address where 
Information describing the first REQUEST Q Is 
stored. The Information avallable Is: 


Read With Lock Word (RLW) 1 byte: 00 = unlocked 

FF = locked 
Request Q Head Address 4 bytes: page, bus, address 
Request Q Tall Address 4 bytes: page, bus, address 


There can be up to nine request queues (one for 
each OCP) numbered 0 through 8. Request queues 
are printed by the dump In the BUFFER section. 


This 4-byte fleld is divided Into three 
sections: first two bytes contain the offset, 
the next byte Is the page number, and the last 
byte [s the beginning address at which 
Information describing the first subnet queue Is 
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RESULT QUEUE ADORESS 


DC BUF MEM ADDRESS 


RESERVED 


LINE INFO SIZE 


PHYSICAL OCP LIMIT 


OC LIST ID 


stored. There Is one subnet queue for each file 
defined in the NDLSYS file. The Information is 
supplied In 10 bytes, divided Into four fields: 


Queue Limit 1 byte 
Queue Count 1 byte 
Subnet Q Head Address 4 bytes: page, bus, address 
Subnet 9 Tail Address 4 bytes: page, bus, address 


The subnet queues are printed in the dump and 
are located In the BUFFER section. 


This 4-byte field contains the offset [In the 
first two bytes, the page number [n the next 
byte, and the last byte contains the bus address 
where Information describing the result queue Is 
stored. There is only one result queve In a 
data comm subsystem. It [s used to return 
information to the OS processor. 


Ten bytes describe the result queue: 


Read With Lock word 1 byte: 00 = locked 

FF = unlocked 
Processor !D 1 byte 
Result Q Head Address 4 bytes: page, bus, address 
Result Q Tall Address 4 bytes: page, bus, address 


The result queue Is printed by the dump [In the 
BUFFER section. 


This 4-byte field Is the page, bus, and offset 
In buffer memory where the data com buffers 


begin. 
These four bytes are currently unused. 


This 2-byte field is the size of each IIne Info 
area. Each line Info area Immediately precedes 
Its respective line table In OCP memory, and 
contains the additional tine [Information needed 
by the OCP. (For a description of ITne 
Information area fleltds, see OCP Memory 
Section.) 


This 2-byte fleld contalns the highest physical 
DCP number attached to the system. 


This I-byte field contains the value used to 
Identify the elements in the data comm Iinked 
block Ifst In OS Memory, and is used when any 
data canm IInked blocks are accessed. 


VIRTUAL DCA MEMORY 


This is the second part of the DCA Memory area. Descriptions of the tables and fields within Virtual 
Memory follow. The items are given in the order in which they appear in the printed dump. 


USER JOB TABLE (LINKED BLOCK ID = 1) 


This table has an entry for each job declared in the mix. For each job, the following fields of informa- 
tion are printed in the dump listing: 


OUTPUT LIMIT/COUNT This array contalns 32 entries, one for each 
al towable task number. Each entry consists of 
two bytes: The leftmost byte Is the current 
value of the task's output limit; the rightmost 
byte Is the current value of the task's output 
count. These values are Initialized to @02@ and 
@00@, respectively, for each user Job by the NDL 
compiler. The user job's task ID Is used as an 
Index Into thls array. 


COBOL ACTIVE FLAGS This 4-byte field consists of 32 bits, one for 
each allowable task number. Each time a user 
Job Is actively executing VERB33, a bit Is set 
for that job's task number. This flag will 
prevent the last MCS from golng to £0OJ and 
terminating the whole OC subsystem while VERB33 
Is active for a task. ODC.EOJ suspends Itself If 
any of these bits are set. 


The fayout of the 32 bits In memory Is as 
follows: 


Bits 7 0 15 8 23 16 31 24 
[ VT lt 1 ] 
Byte 0 Byte | Byte 2 Byte 3 


WAITING QUEUE This array contains an entry for each allowable 
task number. Each entry contains the queue 
reference that the task Is walting on, or @FFFF@ 
if the task Is not walting on a queue. The 
Job's task number Is used to Index thls array. 


LAST COMM This 32-byte array contains an entry for each 
allowable task number. Each entry contains the 
active ADVERB of every VERB33 action betng 
performed. At the end of the VERB33 action, the 
entry |s restored to @FF@. The Job's task ID is 
used to Index this array. 


IPC ORIGIN STATION This array contains 32 2-byte entries, one for 
each allowable task number. This array Is used 
by the IPC communicate to save the LSN of the 
sending IPC program. The LSN can be cross- 
referenced by ustng the LSN INFO Table. The 
Job's task ID is used to Index this array. 
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LAST QUEUE This 32-byte array contains an entry for each 
allowable task number, and Is used with the 
Complex Wait function of MPLII and COBOL. The 
queue identity number for which the job has been 
suspended [Is stored in this field. This field 
works with a round-robin event scanner, looking 
for all or any one of the subnet queues which 
were specified [n the Comptex Walt statement. 
The Job's task ID Is used to Index thls array. 


MCS TABLE (LINKED BLOCK ID 2) 


This table contains an entry for each MCS declared in the mix. For each MCS, the following fields 
of information are printed in the dump listing: 


I 


MCS This Is the relative MCS number. This value Is 
not stored In the table, but rather, Is used as 
an Index Into the table. 


MRA This i-byte field is the ID of the linked block 
that contains the MCS message reference area. 
It can be used as an Index Into the linked block 
list to reference the MRA. 


QUEUE HEAD This 4-byte fleld Is the bus, page, and offset 
address of the head of the MCS queue. 


QUEUE TAIL This 4-byte fleld Is the bus, page, and offset 
address of the tall of the MCS queue. 


QUEUE COUNT This 2-byte fleld contains the current number of 
messages on the MCS queue. 


TASK 1D This l-byte field holds the MCS's Internal task 
number. 
MSG REF This i-byte tieid is the size of the MRA iink 


block defined In the MCS source program. The 
value In this fleld reflects the size of the 
Message Reference Area (MRA) as It was defined 
in the MPLII MCS program. Refer to sections 10 
and 12 of the MPLII Reference Manual, form 
2007363, for additional Information. 


LSNTAB (LINKED BLOCK ID = 3) 


This is the logical station conversion table. This table contains an entry for each station defined in 
NDL. For each station the following fields of information are printed in the dump listing: 


LSN The logical station number as defined in NDL. 
This ts used as the Index when using the LSNTAB. 


PROCESSOR This 2-byte fleld holds the number of the 
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STATION TABLE ADDRESS 


DISK TABLE SIZE 


ORIGINAL OWNER 


CURRENT OWNER 


LLN 


physical DCP to which this station Is attached. 
If this fleld contains @FFFE@, the DCP is 
unloaded due to an error condition In the 
processor. If this fleld contains @FFFF@, the 
station was not declared to be attached to a 
lIne In the NDL, or was detached by a 
REDEF |NE-~STATION canmun Icate. 


This 2-byte field contalns the address of the 
Station Table In DCP MEMORY. Refer to the 
Processor field to determine which DCP Memory to 
reference In the dump- 


This I-byte field contalns the size (In bytes) 
of the Station Table on disk for this station. 


This 1-byte field contains the relative MCS 
number of the MCS that was assigned to this 
station In the NDL fille. If no MCS was assigned 
In NOL, this fleld fs Initialized to @FF@, and 
will later be assigned the relative MCS number 
of the first MCS to access this station. if 
this is a single-MCS system, then this fleld Is 
Inftialfized to @008. 


This !-byte fleld contains the relative MCS 
numer of the MCS that currently owns this 
station. it is initialized to the value of the 
orlginal owner. 


This I-byte field contains the logical line 
number of the lIItne that this station Is 
currently attached to. If the station Is not 
currently attached to a line, this field 
contains @FF@. 


LLNTAB (LINKED BLOCK ID = 4) 


This is the logical line conversion table. This table contains an entry for each line defined in NDL. 
For each line the following fields of information is printed in the dump: 
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LLN 


PROCESSOR 


LINE TABLE ADDRESS 


This Is the logical line number as defined in 
NDL. This value Is used as the Index Into the 
LLNTAB. 


This 2-byte field contains the physical DCP 
number to which thts IIne fs attached. if this 
fleld contains @FFFE@, the DCP has become 
unloaded due to an error condition In the 
processor. 


This 2=byte field contatns the address where the 
Line Table is found In DCP Memory. Refer to the 
PROCESSOR fleld to determine which DCP to 
reference In the dump. 


DISK TABLE SIZE This 2-byte fleld contains the size (in bytes) 
of the Line Table on disk for this line. 


RECON |G PENDING This I-byte fleld ts a flag used to prevent two 
MCSs from simultaneously redefining the same 
line, or fran executing RELOAD white 
RECONFIGURATION or another RELOAD Is executing. 
This flag Is set to @FF@ If a REDEFINE or RELOAD 
fs executing for this Ifne; otherwise, [t Is set 
to @008@. 


SUBTAB (LINKED BLOCK ID = 5) 


This table contains an entry for each subnet declared in NDL. For each subnet, the following fields 
of information are listed: 


SUBNET The relative subnet number as declared [n NDL. 
This Is used as the Index Into the Subnet Table. 


ORIGINAL OWNER This 1-byte field contains the relative MCS 
number of the MCS that was assigned to this 
subnet In the NDL file. If no MCS was assigned 
In the NDL, this field Is Initlallzed to @FF@, 
and later will be assigned the relative MCS 
number by the first MCS to access this subnet. 
If this Is a system subnet, this fleld fs 
initiailzed to #006. 


CURRENT OWNER This field contains the relative MCS number of 
the MCS that currently owns this subnet. It Is 
initialized to thls value by the original owner. 


ATTACHED 

MIX TABLE INDEX This 4-byte fieid contains 32 bits, one for each 
allowable task number. A bit Is set for each 
user job that Is currently attached to this 
subnet. Task numbers range from 0 to 31 and are 
printed here as a set of 32 decimal digits. 


NDL (LINKED BLOCK ID = 6) 


This table contains information that points to the various structures and data within the NDLSYS file. 


MODEM COUNT This t-byte fleld contalns the number of modems 
defined In the NDL. 


TERMINAL COUNT This 1-byte field contains the number of 
terminals defined In the NDL. 


STATION TABLE SIZE This 1-byte field contains the size of each of 
the Station Tables in the NDLSYS file. 


NDLSYS FIB ID This 2-byté fleld contains the ID of the system 


FIB for the NOLSYS file. 
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RECON FIB 


LINE TABLE 
ADORESS 


LINE DISP ADDRESS 


STATION TABLE ADDRESS 


STATION DISP ADDRESS 


MODEM TABLE ADORESS 


MODEM TABLE LENGTH 


TERM TABLE ADDRESS 


TERM TABLE LENGTH 


FILE TABLE ADDRESS 


EX-STATION TABLE 


ADDRESS 


EX-STATION TABLE 


LENGTH 


EX-TERM TABLE ADDRESS 


This 2~byte field contains the ID of the system 
FIB for the RECON file. 


This 2-byte fleld contains the disk file record 
number In the NDLSYS file at which the Line 
Tables begin. Line Tables are on disk in LUN 
order. Full details of the format of the NOLSYS 
fille will be found in the Data Comm Subsystem 
Reference Manual (form 1090909). 


This 2-byte field contains the disk file record 
number In the NDLSYS file of the Line 
Displacement Table. This table contains a 2- 
byte pointer to each Line Table. Index Into 
this table Is by LLN. 


This 2=-byte field contains the disk file record 
number In the NDLSYS file at which the Station 
Tables begin. Station Tables are on disk In 
order of LSN. 


This 2-byte fleld contains the disk file record 
number In the NOLSYS file at which the Station 
DIsptacement list begins. This table contains a 
2-byte pointer to each Station Table. tndex 
into this table Is by LSN. 


This 2+byte fleld contains the disk file record 
number In the NOLSYS file at which the Modem 
Tables begin. 


This 2-byte fleld contains the length In bytes 
of the Modem Tabies disk area. 


This 2-byte fleld contains the disk file record 
number In the NDLSYS file at which the Terminal 
Tables begin. 


This 2-byte fleld Is the total length (in bytes) 
of the Terminal Table on disk. 


This 2-byte field contains the disk file record 
number In the NOLSYS file at which the File 
(subnet) Tables begIn. 


This 2-byte field contains the disk file record 
number In the NDLSYS file at which the Extended 
Station tables begin. 


This 2-byte field contalns the total length (In 
bytes) of the Extended Station Tables disk area. 


This 2-byte field contains the disk file record 
number In the NOLSYS file at which the Extended 
Terminal Tables begin. 
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EX-TERM TABLE LENGTH This 2-byte fleld contains the total length (In 
bytes) of the Extended Terminal Tables disk 


areas 
STATION NAME TABLE This 2-byte fleld contains the disk file record 
DISK ADDRESS number In the NDLSYS fite at which the station 


name table begins. The names are arranged 
alphabetically within the table and each entry 
ts 12 bytes tong, space filled on the right. 


STATION NAME TABLE This 2-byte fleld contains the total length (In 


LENGTH bytes) of the station name tables disk area. 
FILE NAME TABLE This 2=byte fleld contains the disk file record 
ADDRESS number In the NDLSYS file at which the Fille Name 


Table begins. The file (subnet) names are 
arranged alphabetically within the table, and 
each entry Is 12 bytes tong, space fil led on the 


right. 
FILE NAME TABLE This 2-byte field Is the total length (in bytes) 
LENGTH of the File (Subnet) Name Table on disk. 


DCP TERMINALS ADDRESS This 2-byte fleld contains the disk file record 
number In the NDLSYS file at which the DCP 
Terminals (FORMAT B) segment begins. This 
segment contains Information concerning the DCP 
code filles and their assoclated terminals. 


DCP TERMINALS LENGTH This 2~byte field contatns the total length (in 
bytes) of the OCP Terminals (FORMAT B) disk 


Information. 


CP (LINKED BLOCK !D 7) 


This table contains an entry for each DCP declared in NDL. For each DCP, the following fields of 
information are displayed: 


ocP The logical DCP number. This is used as the 
index Into the DCP table. 


FU LENAME This 2-byte fleld contains the name of the 
codefile that Is currently loaded Into this OCP. 


PHYSICAL DCP NUMBER This 2-byte field contains the physical DCP 
number assoclated with thls logical DCP. If the 
DCP was never loaded or Is frozen, this field 
contains @FFFF@. 
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DCPCON (LINKED BLOCK ID = 8) 


The DCP Conversion Table is an 8-byte array (one byte for each allowable DCP) that can be used 


to find a DCP’s logical DCP number when its physical DCP number (bus address) is known. 


The physical DCP number is used as an index into the array to obtain the logical DCP number. 


LSN INFO (LINKED BLOCK ID = 9) 


This table contains additional information for each station declared in the NDL. For each station, the 
following fields of information are displayed: 


LSN 


OUTPUT QUEUE 


OUTPUT SUB Q 


INPUT QUEUE 


ATTACHED MIX TABLE 
INDEX 


The togical station number as defined In NDL. 
This fs used as an Index Into the LSN INFO 
table. 


This I-byte field contains the output routing 
for this station. A value of @FF@ Indicates 
that output to this station will be routed to 
the MCS queue (MCS participating). A value of 
@00@ Indicates that output for this station Is 
routed directly to the station queue (MCS non- 
participating). A value of @FE@ Indicates that 
output to this station will be routed to the IPC 
subnet queue. 


This I-byte fleld contains the valid subnet 
queue number for this dummy station. This fleld 
is used to support the IPC Interface. 


This 1-byte field contalns the subnet number of 
the subnet queue that this station's input wil! 
be routed to. 4@FF@ indicates that this 
station's input will be routed to the MCS queue 
(MCS particIpating). 


This 4-byte field contains 32 bits, one for each 
allowable task 1D. A bit Is set for each user 
Job that is currently attached to this station. 
Task numbers range from 0 to 31, and the field 
is printed as a string of 32 decimal numbers. 


MCSNAME (LINKED BLOCK ID = A) 
This table contains the number of MCSs defined in the NDL, and the name of each MCS. This infor- 


mation is displayed as follows: 
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MCS 


PACK ID 


This ts the relative MCS number. It Is used by 
the system as an index Into the MCS Name IIst. 


This 7-byte field contalns the Pack ID specified 
In NOL for this MCS. 
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FL LENAME This 12-byte fleld contains the MCS File ID. 


MCS-COUNT This 1-byte fleld contains the number of MCSs 
defined In NDL. For sIngle-MCS systems, this 
fleld contains @FF@. 


DCP MEMORY 


The second part of the Data Comm Section is DCP Memory. The DCP memory contains the micro- 
code generated by the NCP900 or NCP900P program, the global data area, and the line- and station- 
related information. These data areas are divided into two subsections, the first being the Reserved 
Pointer Area, and the second being the Line Information Area. If the DC subsystem has more than 
one DCP, the lowest bus address is dumped first, followed by the next higher DCP bus address. 


RESERVED POINTER AREA 


This area contains all of the address and stack pointers necessary to maintain this DCP. In addition, 
this area contains the global data area; and holds information pertaining to PI, line and station sizes, 
processor registers, SAVE state, and processor status information. In short, the majority of key DCP 
information is contained in this area. This information is displayed as follows: 


DCP ADDRESS This fs the bus address of this DCP and Is 
determined by the Analyzer. 


ERRORFORCE, These three flelds are used by the microcode 
INTERRUPTFORCE, when forced through low memory hy the processor - 
CLE ARFORCE 

OS PROCESSOR ID This two-byte field Is the bus address of the OS 


Processor. It Is not byte-reversed. 


{INPUT MAILBOX (IMB) 
IMB REQUEST FUNCTION 


IMB REQUEST PROCESSOR These flelds are the standard 
IMB RESULT PROCESSOR Pl fields. Layout and content 
IMB RESULT FUNCTION of mailboxes Is covered In 
iMB SYSTEM MIX NUMBER Section 10. The oniy vaiues 
IMB AWAITING MAILBOX that are used by the DCP for 
IMB FLAGS request function are @7C4 
OUTPUT MAILBOX (OMB) (dummy pol! response) and @08@ 
OMB REQUEST FUNCTION (DCP waking up DCA to look at 
OMB REQUEST PROCESSOR result queue). 


OMB RESULT PROCESSOR 
OMB RESULT FUNCTION 
OMB SYSTEM MIX NUMBER 
OMB AWAITING MAILBOX 
OMB FLAGS 

MY MAILBOX FLAG 
NM FLAG 


DCP ID This field is Inttalized by the Data Comm Loader 
and should be the Processor ID of this DCP. 
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NDLSYS DATE STAMP, These two flelds are used to check that the NPC 

RANDOM NUMBER microcode file and the NDLSYS file are a matched 
pairs Ouring NPC900, the randon number Is 
Inserted Into both NDLSYS and the microcode 
file(s) that Is (are) belng generated. 


LINE INFO AREA SIZE This field contalns the size in bytes of the 
LINE INFO area. 


PR! LINE INFO This 1~byte fleld Is the size of the extra area 

AREA SIZE needed for multIi-MCS control Information. These 
fields are present In the primary LINE +NFO area 
only. 

DCP END ADDRESS This Is the address In DCP Memory of the end of 


the micraocade- 


DCP TABLES OCP tables are loaded at the top of DCP Memory. 

BEGIN ADDRESS This address polnts to the bottom of the table 
area. (This should be greater than DCP end 
address.) 

BUFFER MEMORY This Its the location of the first page of data 

READ ADDRESS comm buf fers. 

BUFFER MEMORY This Is the location of the first page of data 

RWL ADORESS comm buffers with the RWL bit set. 


PTR TO REQUEST Q PTR This Is the address of the Request Queue 


pointer. 
Bits 7 07 07 0 15 8 
[ im § mt 1U ] 
Page Bus Offset 
PTR TO RESULT Q PTR This [ts the location of the Result Queue 
pointer. 
Bits 7 07 07 0 15 8 
[ 1 It ll ] 
Page Bus Of fset 


PTR to AVAIL.POOL PTR This Is the location of the data conm Avallable 
Poo! pointer. 


Bits 7 O07 O7 0 15 8 
lf lf 
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LINE VECTOR TABLE 


HC LINE NEXT POINTER 


HC LOOP FLAG 


HC LINE FUNCTION 


MAX S TATIONS TABLE” S1U7E 


HC LINE CHANGE COUNTER 


HC LINE BACKWARD 
POINTER 


HOST LINE PRIORITY 


P} SEND Q HEAD 


DCP RESULT Q 
HEAD ADDRESS 


DCP RESULT Q 
TAIL ADDRESS 


DUMMY STATION TABLE 


LINE INFO 
BASE ADDR TABLE 


This Ts an array of 16 2-byte entries, one per 
port. Each entry Is the address of the related 
Line Table entry. Unused ports have an address 
of @FFFF@. Port 0 fs used for interprocessor 
communication (PI). This port should have an 
entry of @FFFF@. 


NOTE 


For entries HC LINE NEXT POINTER 
through HOST LINE PRIORITY, for 
the purposes of SCHEDULER, host 
control (HC) Is treated as an 
additional tine, and has a 
pseudo LINE INFO area. This 
group of fields Is that area. 


This Is the forward link to the next Iine. As 
HO Is always the "last line," this points to the 
first l!ne In the queue for Line Manager. 


Unused. 


Address of code to be executed by host control 
when It galfns control. 


Indicates the size of the station tables used In 
this DCP (elther normal or extended). 


HC only runs every nth cycle (currently every 
10th). This counter controls the size of the 
cycle. 


This is the backward iink to the previous HC 
i Ine. 


This fleld fs always 0. 


DCP memory address of the head of the PI queue. 


Address In buffer memory of the head of the DCP 
result queue. 


Address In buffer memory of the tall of DCP 
result queue. 


Used as a work area during Station Table 
operations. 


This table contains the address of the Line 
Table entries In LLN order. Al! unused entries 
are filled with @FFFF@. 


RELOAD IN PROGRESS 


ENHANCEMENT BYTES 


NPC VERSION 


STATE SAVE AREA 


ERROR NUMBER 


This t-byte field Is set to @FF@ by the OS to 
request that the OCP enter [ts IDLE state In 
preparation for reloading. This fleld Is reset 
(€00@) by the DCP when It Is "Idle". 


Reserved. 


This Is the version of the NDL Post Compiler 
(NPC) used to generate the microcode file 
currently In the OCP. 


If the DCP develops a problem or becomes "hung," 
this area allows the same degree of debugging as 
any other processor. A detalled description of 
the State Save Area Is contained In the OS 


Se Pe ee ne oy ers 
Processor section. 


This fleld in the State Save Area Is special to 
the OCP processor. Error numbers and their 
meanings are: 


@00@ : Hardware error. 


@01@ ; Interrupt error. 
An unexpected fnterrupt has occurred. 


@02@ : NDL error. 
The DCP has detected an error In the 
suppl ted NDL that makes further execution 
unsafe. 


4034 : Initialize error. 
The OCP branched to address 0, and has 


gone through Initialize code twice. 


Errors @02@ and @034@ wil! probably require TIO 
or plant resolution. 


The values [In the State Save Area have no 
meaning unless the data canm was active at the 
time of the dump. 


LINE INFORMATION AREA 


Information regarding the lines under control of this DCP is held in three parts. The first part is the 
“Line Number”’ area. This area holds all pointer information work areas, flags, etc. The second part 
is the standard CMS ‘‘Line Table.” The third part is the ‘‘Station Table’? entries for all stations on 


this line. 


LINE NUMBER 
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NEXT POINTER 


This 2-byte field contalns the absolute address 
of the next line Info area In the "Round Robin" 
queue. 
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PORT NUMBER 


FUNCTION 


RETURN POINTER 


BACKWARD PO INTER 


PRIORITY CODE 


PRIORITY PTR 


ACTIVE STATION PTR 


ACTIVE STATION 


ACTIVE STATION 
VECTOR PTR 


WORK1 thru WORKS 


CURRENT BUFFER 


THIS BUFFER SIZE 


THIS BUFFER SIZE SAVE 


SAVE POINTER 


This fs the physical port number. It Is 
malntalned as a bit mask where Port 2 = 604@, 
port 7 = @80¢@. 


This ts the address of the microcode that 
handles the anticIpated event. If the line has 
never been made ready, this fleld will be 0. 


The code address to return to when the active 
function completes. 


Points to the previous entry In the "Round 
RobIn" list. Onty used In queue delinking- 


The line prtority to be used when placing this 
line Into the top-down Manager queue. 


Points to the next line at the highest prfority. 
If fhis ts the only one, then this fleld will 
point to Itself. This field Is used In the Line 
Manager for top-down scheduling. 


Contains the DCP memory address of the Station 
Table entry of the currenly active station (If 
any). 


Contains the RSN of the currently active 
station (the NDL variable "STATION"). 


Contains the DCP memory address of the current 
station’s Station Vector In the Line Table. The 
Station Vectors are contalned in the CMS table 
station descriptors. This fleld is redundant 
for the dump reader, as the appropriate entry 
can be readily found by use of the RSN fleld. 


Temporary storage areas. 


Absolute address of the base of the current 
buffer. 


Contalns the remaining buffer size. This fleld 
1s updated at buffer crossover. 


This Is used to store “THIS BUFFER SIZE" at 
buffer crossover timee This Is necessary to 
enable the system to correctly handle a 


BACKSPACE after the last character has been 
stored. 


Used by subroutines that enter the Manager. This 
ts not the normal mode of entry. it fs used 
when a needed return address sits on the top of 
the NBDS stack and the future Integrity of the 
stack Is In danger due to an Impending yleld to 
another IIne- 
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BUFFER SIZE 


BUFFER COUNT 


TERMINAL NUMBER 


INPUT CHARACTER 


CHARACTER 


TIMEOUT 


TEXT SIZE 


RETURN TO POINTER 


CRCL 


BCC CRCM 


ADAPTOR DESCRIPTOR 


DATA SET CESCRIPTOR 


MESSAGE HEADER/LENGTH 


TERMINAL SAVE Q LIMIT 


YIELD COUNTER 


AT LEAST TWO 
CHARACTERS 


Contains the rematning buffer space. This fs 
matntalned In twos complement and Incremented 
with each character stored. A value of 4@FFFF@ 
Indicates overflow. 


The absolute address of the next character 
position to be read from or written to. 


Contains the logical terminal number assocl ated 
with the currently active station. 


Contains the translated and checked Image of the 
last character on the IIne. (NDL CHAR) 


Contains the last character as It appeared on 
The jine. (NOL LCHAR) 


Used to store S-OP-defined times. 


Contains the current amount of text accumulated 
or transmitted so far. This Is matntained In 
ones complement form. It Is updated only on 
buf fer crossover by the amount in 
THIS.»BUFFER.SIZE. 


Contains an S-OP address where control will be 
returned when current function Is completed. 


Holds lower byte during CRC calculations. 


Holds BCC or upper CRC byte during BCC/CRC 
generation. 


A copy of the DC! hardware register. 
A copy of the DCI hardware register. 
Contains MAXINPUT for the current terminal. 


Contains the limit for the Output Save Queue of 
a given station. The limit Is specified in the 
station's Terminal Table. Because the terminal 
tables are not stored in DCP memory, the 


TERMINAL SAVE Q LIMIT fs stored in the Line 
Configuration area and updated at station change 


time. 
Used to ensure that a high speed line does not 


monopol!ze a data comm processor's time. 


Used to determine If certain BDLC receive S-OPs 
have received at feast two characters. 
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STREAM A 


STREAM B 


ADAPTOR ABORT INFO 


Subnet 
Queue 


0 


Used to buffer TRANSMIT TEXT data from data conm 
space to the adaptor. 


Same as Stream A. 


This ts two I-byte flelds which contain 
Information to be copied to the RESERVED and 
SUBQ flelds of a LIne Not Ready result header 
(with adaptor fault event set). These fields 
are also valid In the case where a function Is 
returned with the result UNABLE TO INITIATE 
caused by an adaptor mismatch. The following 
Information Is helpful: 


Corresp- 
Reserved 
Description Fleld Description 
No CTs after n/a 
8 seconds 
No adaptor 0 Delay operation 
present 
1 Transmit 
2 Rece I ve 
Switched line establish 
dialout 
4 Dialout 
5 Adaptor lost 
Adaptor not n Where n = ID of adaptor 
dialout capable 
Line address n Where n = ID of adaptor 


requires dual ENDC 
LEM link parity 0) Read 


i Write 


MESSAGE HEADER POINTER Contalns the absolute address of the message 


HOST WORK! thru 4 


DUMMY TALLY, 


DUMMY DESCRIPTOR, 
DUMMY STATION POINTER 


FLAGS 
Bits 
FLAG 1 7 
6 


area currently [In use. 
Used as host control work areas. 


Used In place of STATION TALLY, STATION 
DESCRIPTOR, and STATION POINTER when an Invalid 
station has been chosen. 


These fleids reflect the state of the IIne- 
Individual bytes contaln the following flags. 


Message Meant ng 
NOT USED 
CRC The CRC toggle tn NOL. If TRUE, 


horizontal parity Is generated. 
If FALSE, horizontal parity Is 
not generated. 
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FLAG 2 


FLAG 3 


Bits 
5 
4 


Message 
NO. TRANSLATE 
SYNCS 


FULL DUPLEX 


TRANSPARENT 


MIDDLE SHIFT MODE 
UPPER SHIFT MODE 


RCV TEXT 


ZERO TIMEOUT 


INPUT FLAG 


LINE CONTROL 


SPACE AVAIL 


HOR I ZONTAL OOD 


CRC.1 


SYNC/ASYNC 


FUNCTION IN 
PROGRESS 


VERTICAL EVEN 


Meant ng 
No translation 


Store recelved syncs 
Set for full duplex 


LIne fs In transparent mode 
Set/Reset by binary = TRUE/FALSE 


When using caseshI ft translation, 
these flags define the shift mode 
In ef fect. 


Set while receive text ts In prom 
gress so that the common receive 
manager can distinguish a RCY 
text from a RCV character. 


The last receive Instruction had 
0 as Its time value. (0 requires 
special handling In the manager.) 


lf set IIne had no output space 
for half-duplex, this Implies that 
lIneé Is In Ifne control or Input 
request mode. 


Set when NDL fs running the line 
control or auxiliary !Ine control 
of the program for this IIne. 


Message space Is avaliable. Set 
after successful getspace, or on 
entering an output request 


Set If using odd horizontal. 
parity. 


Indicates CRC polynomial In use: 


Os KPRL 6H HT SH tt 2+1 
Tos RL Gta] 245 +1 


TRUE imp! tes ASYNC. 


if set, HC does not get a message 
off the request queue for this 
lines Aiso, Inhibits S~OPs 
from Interrupting the IIne, Irre- 
spective of the state of the IIne 
(busy). 


Set If even vertical parity is 
present. 
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FLAG 4 


Bits 


Mes sage 


NEW CHAR PRSNT 


STA-NRY.» PENDING 


LN.NRY. PENDING 


XMT/RCV LAST 


ABORT IN PROGRESS 


FLAG.FILLING 


WAIT FLAG 


AUX ACTIVE 


AUX 


IGNORE BREAK 


FLAG EXPECTED 


OLD TRANSPARENT 


ADAPTOR IN USE 


Meantng 


Set If 
new character from IIne. 


recelve manager received 


A Make-Statlon-Not-Ready request 
has been made for this station. It 
wil! be done after THIS.FUNCTION. 
Impties that line (busy) Is TRUE. 


As above, but for line. 


Indicates whether the most recent 
function was a transmit or recelve- 
Used In byte variable and toggle 
accessing for values that are maln- 
talned on the adaptor (1 for each 
stde XMIT and RCV). True = RCV. 


In a multi-MCS environment, the DCP 
Is In the process of Informing all 
MCPs that a line abort has occurred. 


The BDOLC line Is currently flag 
filled. 


Set If line Is In Wait. 
Set If auxIlfary line Is fn Itne 
queue. 


Indicates that this Line 
Information area Is an auxiliary 
of a full-duplex pair. 


Indicates to the transmit 
messenger that the S-OP wishes 
to Ignore a bre& condition on 
an ASYNC Iine and under flows 
on a SYNC IIne. 

The recelver expects a BOLC flag. 


Reflects the state of transparent 
for the most recent XMIT/RCV. 
Alds In the retrieval of the 
character, since transparent could 
have changed state from the time 
the character was received and 
Its access. 


An Instruction requiring the 
presence of a IIne adaptor has 
been executed. 
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FLAG 5 


FLAG 6 


Bits 


Message 


NOT USED 


Meantng 


TERMINATING BLOCK Set If terminating block. 


NO LINE CTRL 


DCIB TRUE 


HOST MCS FLAG 


NOT USED 


INV FRAME 


ABORT LINE 


LINE LINKED 


LINE LOAD 


LINE STREAM 


LINE BITS 


TERM | NAT ING 
DISABLE OUTPUT 


NOT USED 
NOT USED 


NOT USED 


INVALID QSR 


Set if shouldn't re-write line 
control after pending resolution. 


Set If the !Ine adaptor ts DCIB. 


Indicates logical state of the 
associated MCS. 


Set If the BDLC line has recelved 


an fnvalid frame. Its use Is 
Internal to the routine that pro~ 


cesses recelve errors. Should be 
0 outside that routine. 


Set if LEM line error occurred 
during Make-Line-Ready process 
before Line Linked Is set. 


Set If Line Ready process has 
linked IIne Into line list. 
Line can be made Not Ready at 
this point. 


Indicates which strean field 
must next be loaded with trans- 
mit data: 0O= String A 

1 = string B 


Indicates which stream field is 
current: 0 = string A 
1 = string 8 


Set If line Ts BDLC. 


Set If Terminate Disable Input 
Is being processed to distingulsh 
It from a Terminate. Error Is 
common codes 


Set when the OCP firmware notices 
a pecullar condition on the IIne 
adaptor. 
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COUNT A 


COUNT 8B 


PRIMARY POINTER 


CO LINE POINTER 


LNE PENDING MCS 1D 


LNE LOG LN RDY COUNT 


LNE HOST MCS 1D 


LNE MCS LOG STATE 


LNE SNR MCS DATA 


LNE LNR MCS DATA 


LINE TABLE 


STATION TABLE 


The number of characters [n stream A. 
The number of characters In stream B. 


Address of the LINE INFO AREA of the primary 
\Ine of a full-duplex palr. For hal f-duplex 
pair, for a half-duplex IIne, or for the 
primary, this will point to Itself. 


Address of the LINE {NFO AREA of the aux IIne of 
a full-duplex pair. For a half-duplex Hine, this 
fleld Is @FFFF@. For the aux tine of a full- 
duplex palr, this fleld points to Its primary. 


This 1-byte fleld Is used If an MCS Is making a 
Itne Ready/Not Ready, and holds the MCS relative 
routing number of the requesting MCS. This field 
Is used tater (when the action Is finished) to 
route the result of the line condition back to 
the parent MCS. 


This 1-byte field Is used to hold the number of 
lines the MCS has ready. 


This I-byte field Is used as a Save Area for the 
MCS 1D, and Is used in relationship with any 
pending operation (such as making a !ine Ready). 
When the operation (function) Is conpleted, this 
fleld Is copled Into the result descriptor 
header. 


This array Is 16 bytes long, and Is used to hold 
information on the state of the lines (one byte 
for each fine). @00@ Indicates the line Is Not 
Ready, @FF@ Indicates that It Is Ready. 


This 2-byte fleld Is used to hold the MCS data 
fleld of a MAKE.STATION.NOT.READY message header 
If that header encounters a Pending condition. 
This fleld wil! be copled to a new header and 
returned to the MCS when the Pending condition 
is resolved. 


Same as above, for MAKE-L!NE.NOT-READY. 


The meaning of the contents of this table are 
Identical to that described In the NOL tables In 
this section of the manual. For information on 
the usage of the Line Table, refer to the Data 
Communications Subsystem Reference Manual, form 
1090909. 


This table ts Identical to the area described In 
the NDL tables found in this section. For 


additional Information on the Station Table, 
refer to the Data Communications Subsystem 
Reference Manual . 


BUFFER MEMORY 


The third and last area of the data comm dump section is the set of data comm buffers. Buffers are 
listed in relation to the structure to which they belong. All buffers are laid out in the following manner: 


Byte Description 


0-3 Link to next buffer In this message with 4&FFFFe 
the last buffer. 

the first b 

to the next message. | 

the fleld Is @FFFF@. 


~~ mn anna Th ~~ tate 
fa MSSSGGS, 1 pOorirs 


3 + 
t Is not the first buffer, 


2 
> 


8-n Message text. 
NOTE 


In the first buffer of a message, the 
first 36 bytes contaln the MCS header. 


AVAILABLE BUFFER POOL (ABP) 


The Available Buffer Pool is a set of buffers. The size was allocated by the DC BUFFER field of 
SYS.CONFIG and by the NDLSYS file using the DCP section buffer fields. All buffers are dumped 
to allow a trace of a recent message. By using the two link fields, buffers can be linked forward or 


backward. Information on the linking fields follows. 


ABP READ WITH LOCK A i-byte field used by the Read-With-Lock 
hardware (@00@ = unlock, @FF@ = locked). 


ABP PROCESSOR ID This contains the 1D of the processor using the 
ABP. 

ABP COUNT This fleld contains the number of buffers In the 
ABP. 

ABP HEAD This fletd points to the head of the ABP. 

ABP TAIL This field points to the tail of the ABP. 


The ABP buffers are located here in the printed dump. 
RESULT QUEUE 


The result queue area is laid out similarly to the ABP. The fields are identical in function to those 


of the ABP. 
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REQUEST QUEUE 


The request queue for each DCP number is given here. The fields are identical in function to those 
of the ABP. 


SUBNET QUEUE 


The contents of each subnet (NDL file) is given here. The fields have the following significance: 


QUEUE NUMBER Analyzer developed reference (logical Q noe). 


QUEUE LIMIT The current queue Iimit for this subnet. 
Default value is 2. 


QUEUE COUNT The number of messages In this subnet queue. 
QUEUE HEAD/TAIL The addresses of the head and tafl of the subnet 
queue. 
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SECTION 10 
TASK PROCESSOR 


INTRODUCTION 


This section of the manual provides a field-by-field description of the Task Processor (TP) portion of 
the dump. Data contained in the TP section includes: 


Input and output mailboxes used to communicate with the OS processor 

Pointers used to locate system and task structures in the task processor memory 
State Save Area, used to store information when a nonrecoverable error is detected 
Analysis of memory utilization 

Breakdown of interpreter and task run structures 

Status information for each task 


A section titled ‘‘Task Processor on BUS nn,”’ is printed for each TP on the system. The first indica- 
tion of a task processor failure is usually the message, ‘‘Task Processor <BUS ADDRESS> 
LOGICALLY NOT READY,”’ displayed on the SPO. In this instance, the procedure discussed in the 
following paragraphs should be performed. 


INITIAL DUMP ANALYSIS 


There can be one of two reasons for a task processor to be in a LOGICALLY NOT READY state. 
The first reason is that the task processor detected an internal failure and stopped communication with 
the OS processor. 


The second possible reason is that the OS processor failed to receive a response from the task processor 
which the operating system had polled. 
In both of these cases, t 


e OS freezes the task processor and attempt e nd 
ever, it should be noted that, in the first case, a processor maintenance entry will be logged. This entry 


contains the same information as the State Save area. 


The initial step in dump analysis is to identify the bus address of the failing task processor. This can 
be achieved by looking at the system log or by examining one of the following fields in the system 
dump: 


Frozen Processor field found in the Dump File Parameters section (page 2 of the formatted dump 
file) 


Dump File Map (third section in the dump file) 


PI Dead Processor found in the PI Data Area of the dump’s OS section (which follows the History 
Communicate Table). 


The Save State Address is always primed. If the OS detected the error, the Save State information 
will be invalid and will be initialized to 3 bytes of @FF@, 49 bytes of @00@, and 10 bytes of @FF@. 


If the task processor detected the error, the Save State information will be valid. 


If the error number is @47@, the error was hardware-detected. Interrogation of the IC Status fields 
found in the State Save Area will indicate the type of hardware failure. More detail on State Save 
Area analysis is contained in section 8 of this manual. 
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If the error number did not indicate a hardware failure, the fields IMB FUNCTION and IMB FLAGS 
should be examined. These fields indicate the last function that was performed and the current status 
of the input mailbox. Possible entries and their messages are discussed later in this section. 


Repeat this step for the OMB REQUEST FUNCTION and the OMB FLAGS. If the reason for the 
error cannot be determined, further analysis will be required. The rest of the task processor fields are 
detailed in the following subparagraphs in the order in which they appeared in the dump. 


TASK PPROCESSOR ON BUS nn 


ACOUNT This Is the address resolution count. The 
Information shown here |s used In the detection 
of thrashing. 


STATE SAVE AREA This fleld will always be primed to the address 
ADDRESS of the State Save Area. 


MAILBOX DESCRIPTIONS 


The Input Mailbox is used for messages from the OS to the TP. The Output Mailbox is used for mes- 
sages from the TP to the OS. For a full explanation of mailboxes and their use in interprocessor com- 
munication see section 4. 


{NPUT MAILBOX (IMB) This area is used to store the message passed. 

TEXT The exact usage !s defined by the request 
function fleld. The text area contains the 
Fetch Communicate Message (FCM) If communicate 
Information Is Indicated In the request funct ton 
tleld. 


IMB REQUEST FUNCTION This fleld is used to Indicate the type of 
Information In the text area. When the request 
bit (MSB) Is set In the IMB flags, the OS Is 
requesting the task processor to perform a 
functton. 


These functions are as follows: 
@07@ Command handler. 


ecse = Interpreter load. 
e03@ = =6Monitor action. 
@FF@ Oata move function. 


Parameters to these functions are In the {MB 
text area, as shown In figures 10-1 and 10-2; 
responses are shown In figure 10-3. 


\f the TP had previously requested, by means of 
Its output maflbox, action tn the OS, there may 
be a result to be passed back to the TPe In 
this case, the request function will be the 
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TASK PROCESSOR INPUT MAILBOX 
TEXT AREA = 16 BYTES 
FOR NON INTERP ACTIONS THE COMM.AREA CONTENTS WILL VARY 


DEPENDING ON WHETHER THEY ARE RECEIVED FROM THE OS OR ARE TO 
GO TO THE OS. THEY ARE ALSO ACTION DEPENDENT. 


OS—®>COMMAND HANDLER (FUNCTION ID = 07) 


BYTEO= 00 RUN (LOAD) 
01 PREPARE TO SUSPEND 
02 PREPARE TO WAIT LONG 
03 REQUEST FPB NO. 
04 REQUEST SEG. SIZE 
os PREPARE TO MONITOR 


PREPARE TO REMOVE JOB 


fees | Garaeae PRIORITY] SIZEOFTCB | PRIORITY HELD IN 2 LSB. 1=C, 2=B, 3=A. 
PREPARE or | FILE IDOF REMOVE 02 DESIGNATES “SAVE DATA STRUCTURES.” 01 DESIGNATES “RM DATA STRUCTURES.” 


SUSPEND VM FILE SAVE 


GET FPB NO. 


PREPARE 
REMOVE 


eee pemoye 02 DESIGNATES “SAVE DATA STRUCTURES.” 01 DESIGNATES “RM DATA STRUCTURES”. 
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Figure 10-1. TP Input Mailbox Format for Function 07 


TASK PROCESSOR INPUT MAILBOX 
TEXT AREA = 16 BYTES 


OS -» MONITOR ACTION (FUNCTION-ID = 09) 


BYTE 0 = OP.CODE = 02 REQUEST “BUSYNESS” FACTOR 
ELSE CONSIDERED AS PROCESSOR POLL. 


OS-® COMMUNICATE REQUESTOR (FUNCTION-ID = FF) NOTE: REQUEST BIT IN FLAGS IS RESET. 
SSS ee eee 
BYTES 13,14,15 = FCM 


OS -® INTERPRETER LOAD (FUNCTION ID = 08). INVOKED AT WARMSTART. 
ee AIS TART 


FILE 1D OF 


OF INTERP. SEG. TABLE 


NOTE: 

SINCE AT WARMSTART THE 08 WILL SUSPEND WAITING ONA RESPONSE 
TO THIS REQUEST, FAILURE OF THE TP TO PROVIDE SUCH A RESPONSE IS 
FATAL TO WARMSTART. THE SYSTEM WILL HANG. 
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Figure 10-2. TP Input Mailbox Format for Functions 08, 09, FF 
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TASK PROCESSOR OUTPUT MAILBOX 
TEXT AREA = 16 BYTES 
RESPONSES 


| ! 
| como To | 
| | RESPONSE FROMACTIONOT, 
| ia ELSE TO OP-CODE 00 
| SYS10 RESULT 
| | 


TASKID RESULT 


FPB NO. SEG SIZE RESPONSE FROM ACTION 07, TO OP-CODE 03. 
| | 


! 
\ { | 
RESPONSE FROM ACTION 07, TO OP-CODE 04. 


| 
RESPONSE FROM ACTION 08. 
NACK re jt Se 


£02647 


104 


Figure 10-3. TP Output Mailbox Format 


action ID of the requesting action, the request 
bit wil! not be set, and the IMB text area will 
contain the response. 


{MB REQUEST PROCESSOR This field contains the bus address of the 
processor originating the request. (Not used by 
task processor.) 


IMB RESULT PROCESSOR This fleld contains the bus address of the 
processor this message went to. (Not used by 
task processor.) 


IMB RESULT FUNCTION This fleld contatns the ID of the action that Is 
to recelve the result. When the function fleld 
points to a TP action, the ID Is an Index Into 
the status block address arrays 
Refer to the "SB address array" description In a 
tater subsection. 


IMB SYSTEM MIX NUMBER This field contains the mix number of the number 
of the job Identified In the OS processor Mix 
Table. tnformation passed Is assoclated with 
this Job. 


| RESPONSE FROM ACTION 07, TO OP-CODE 01 OR 06. 


meee cago 


NOTE: BYTE 4 = 01 — SUSPENDED 
06 — REMOVED 
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IMB AWAITING MAILBOX 


IMB FLAGS 


Not used. 
The bit assignments of the flags are as follows: 


MSB 7 —- Request 
6 - Unused DCP 
5 - TP error 
4 - Rejected by TP 
3 = Accepted by OS 
2 
1 
0 


Glven to 0S 
- Accepted by TP 


LSB Given to TP 


The following flag values Indicate the most 


common transaction sequence and may help to 
Identify the status of the tevt area: 


@08@ Mailbox owned by 0S 
@81@ Mal lbox contains data for TP 
@84@ TP has accepted the Input message 


@06@ may also be seen in the flags fleld. This 
Indicates a successful data move by the TP. 


The meanings of the flags without the "8" bit 
are also as above except that the text contains 
a response from the OS rather than a request. 


OUTPUT MAILBOX (OMB) TEXT 


OMB REQUEST FUNCTION 


e15@ 


630@ 


e47@ 


643 @ 


@40e 


REQ-SYSMES 


Text same as for Input Mall box. 


This field Is used to [Indicate the type of 
information contained in the mailbox text area. 
Values here represent action-IDs In the OS. 


When the flags request bit is set, the following 
flag values are used: 


SAGE TP request to display Information on the 
OOT/Remote SPO. 


REQ.10 TP request to bring a structure {nto its 
memory « 

REQRUNNI NG TP Informing the OS that a Job has been 
loaded or restarted, and should now be 
marked as executing. 

REQ REMOVE TP Informing OS that a task has been 
suspended or terminated as requested. 

REQ. THRASH ING Tj Informing OS that a thrashing 


condition exists. 
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INTERPRETER SAVE 
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@52@ REQ.JOB-ERROR TP Informing OS that an error has been 


@8B@ = REQ-MONITOR 


detected. Probably DS-DP condition. 


Invokes DUMMY action In OS to confirm DP 
stilt! allve. 


@FF@ REQ-COMMUNICATE First byte of text = communicate. 


OMB FLAGS 


SIGNAL OUT LOCATION 


ERROR OFFSET 


INTERP KOUMP, 
INTERP SINTFLAG, 
INTERP SICOUNT, 
INTERP LDUMP, 
INTERP TCBPTR, 
INTERP TCBPAGE, 
INTERP RTRNOUMP, 
INTERP JDUMP, 
INTERP COMMPTR 


OMB request processor, OMB result processor, OMB 
result function, OMB awalting mailbox, system 


mix number are the same as IMB. 

The bit assignments of the flags are as follows: 
MSB 7 : Request 

6 : Unused OCP 

5 : TP error 

4 : Rejected by OS 

3 : Accepted by 0S 

2 : Given to OS 

1: Accepted by TP 

0 : OS acknowledgment 


LSB 


The following flag values Indicate the most 
common transaction sequence, and may help to 
identify the status of the next area. 


@02@ = 8=©Malilbox owned by TP 

@4@ Mallbox contains data for 0S 

@1@ OS has accepted the maf!box request 
@02@ =©Mal!box owned by TP 


The meanings of the flags without the "8" bit 
are the same as above except that the text 
contains a response from the TP rather than a 
request. 


This Is the location where the task processor 
sets a flag to alert the OS to check the 
mal {boxe 


This fleld points to the location In the task 
processor code where the error was detected. 


AREA 


These are fields used by the Interpreter to save 
off Information during Interrupt handling, erce, 
to enable contro! to be reinitiated at the 
correct place. 


POINTER FIELDS 
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OS BUS 


Current Task 


OS Request Task 


Terminate Tasks Task 


Current Message 


Terminate Queue 


Task References 
First Job 


Ready Queue 


Please Yield 


Allocates Called 
Allocates Idled 
Al locates Measure 
Page Reference 


Last Page 


Blocks Lock 


ICB First Page 


ICB First Location 


This field contains the bus address of the 
operating system Interrupt handling to enable 
contro! to be reinitiated at the correct place. 


This fleld contains the ID of the task which has 
control of the task processor. 


This fleld points to the task requested by the 
oS. 


This fleld points to the task which its 
terminating. 


This fleld points to the mallbox containing s 
message for the current task. 


This fleld pofnts to the tasks walting to be 
terminated. 


This Is a JIst of user Jobs or TP-created tasks. 
This field points to the first user task. 


This fleld points to the next Job which wit! 
obtain control of the task processor. 


The OS Is requesting the task processor to give 
up control of the current task. Possible values 
are: 


@FF@ = OS requesting processor to yleld control 
@008@ = No request from OS 


These flelds are used to determine processor 
activity. 


This fleld points to the pages of the task 
processor.» 


This fleld Indicates the number of pages on the 
task processor. 


@00@ = Unlocked; @FF@ = Either a TCB, PCB, or 
ICB Is In the process of belng created/deleted. 
While In a locked state no one may make or 
delete from this block. 


This one byte field polnts to the page of the 
first iCB. 


This fletd points to the location on the page of 
the first ICB. 
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ICB Last Page 


ICB Last Location 


Mal tout Lock 


OS Processor 


Task Processor 


H Bugspace Location 
Bugspace Location 
Num Debug Text 


Task Run Space 


No Task Space 


Segments 
Task Kind 


SPACE ANALYSIS 


This area reflects the state of each page of memory in the task processor. Since hardware memory 
addressing is not continuous across pages, memory management of each page is effected independently. 


This fleld potnts to the last ICB on the IIst on 
a particutar page. 


This field polnts to the location on the page of 
the fast ICB. 


The PCB and TCB potnter flelds, which are the 
next efght entries, are the same as the ICB 
pointer fields above. 


A value of @FF@ Indicates a locked condition. 
This lock Is used to control access to the 
mallbox which can be used by only one task at a 
time. 


This fleld contains the bus address of the OS 
processor « 


This fleld contains the bus address of the task 
processor 


These fietds will always have a value of zero. 
They are regarded as reserved fields. 


This fleld contains the address of the next task 
to be loaded. 


A value of @FF@ means there is no space to load 
a task on this processor. 


These are compiler-related flelds. 


For each page of memory present, the following fields are listed: 
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Page Number 


First Space, 
Last Space 


Lock 


This fleld Indicates the memory page in the task 
processor. 


These flelds contain the addresses of the lowest 
and highest spaces In the page- The spaces of a 
page are linked forward and backward in memory 
address ordere Therefore, the spaces of a page 
can be searched In either direction. 


A value of @FF@ means locked. Since each page 
has Its own lock, memory management in several 
pages can proceed concurrently. This lock Is 


Task Walting 


First Aval lable 


GS Count 


Blocks 


used to control memory allocation on each page 
of memory In the task processore This lock can 
be used by only one task at a time. 


This field contains the task record addresses of 
tasks walting on a lock. 


This fleld contains the address of the lowest 
addressed available space. Al! the available 
spaces In a page are IInked together [In memory 
address order. 


This is the Get Segment Count that Is used In 
detection of thrashing. 


The number of PCBs, TCBs, or ICBs contained on 
that page. 


Each page of memory in the Space Analysis section contains a table of the space allocation of the 
memory on that page. It contains the column headings NEXT, LAST, SIZE, STATE, and USED. The 
information under these headings is explained as follows: 


NEXT 


LAST 


SIZE 


STATE 


USED 
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The NEXT fleld Is the forward lInk to 
adjacent spacese LAST (preceding entry ) 
+ SIZE = NEXT (unless NEXT = NULL). 


The LAST fletd Is the backward link to 
adjacent spaces. An example of how to 
read the NEXT and LAST fields Is given In 
figure 10-4. 


This field Is the size of the space in 
bytes, Inclusive of the space record 
Itself. 


The state of the space can be either 
avaliable, over layable, or non- 


over layab le. 


This fleld Is a usage count for S- 
SEGMENTS» 


@07@ = used, @008 = available. 
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PAGE NUMBER O02 
FIRST SPACE 0000 
LAST SPACE FFE8& 
Lock a0 
TASK WAITING GOGO 
FIRST AVAILABLE 1476 
GS COUNT 08 
BLOCKS 0001 
ARCOUNT A4GFF 


NEXT LAST 
hate aaann 
0608 0000 
0167 0000 
O2A9 0008 
0497 0167 
0776 O2a9 
09A0 0497 
OFB9 0776 
T13A 09a0 
146651 OFB9 
FF3A T3A 
FFEB 14682 
0000 FEA 


SIZE 
sant 
oc0s 
O1s¢ 
Oté2 
OEE 
O2pdF 
O22A 
0619 
0181 
0334 
EACC 
OOAE 
0008 


STATE 

Rather 

FF NON OVERLAYABLE 
80 OVERLAYABLE 

80 OVERLAYABLE 

80 OVERLAVABLE 

80 OVERLAYABLE 

80 OVERLAYABLE 

80 OVERLAYABLE 

80 OVERLAYABLE 

80 OVERLAYABLE 

OO AVAILABLE 

FE NON OVERLAYVABLE 
FF NON OVERLAYABLE 


A sample space allocation table is shown above. Assume that you wish to locate the last area of 
AVAILABLE space in the Hex dump. The line of information relating to this area has been outlined 
so that it will stand out. This piece of memory, of size EACC (in Hex), is located between two ad- 
dresses of 146E. These addresses are the NEXT of the preceding line(1) and the LAST of the line which 
follows(2). This indicates that the available entry is located at 146F in this page. 


Figure 10-4. Example of How to Read NEXT and LAST Fields 
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BLOCKS 


There are three kinds of blocks: Interpreter Control Blocks (ICBs), Program Control Blocks (PCBs), 
and Task Control Blocks (TCBs). There is an analysis section for each kind of block in the dump. 


ICB ANALYSIS 


This area contains interpreter information. There is an ICB ANALYSIS section for each interpreter 
in a task processor. A description of the fields as they appear in this section is as follows: 


iCB Page This tieid indicates the page where the iCB is 
located. 

ICB Location This field Indicates the location of the ICB on 
the page. 

Space Next, These are forward and backward memory links [fn 

Space Previous the space record. 

Space Size This field Indicates the size of the ICB In 
bytes. 

Space State The space state can be elther avaliable, 


over layable, or non-over layable. 


Space Used 6078 Indicates recentiy "used", and «8008 
Indicates "available." 


The BLOCK HEADER is comprised of the next six fields appearing in the dump. This area precedes 
all ICB, PCB, and TCB records. These fields provide a description of the block, and are linked to 


previous blocks of similar type on a task processor page. The fields are named Next Page, Next Loc, 


reor 
Previous Page, Previous Loc, Kind, and ID. 


The following fields appear in the dump after the Block Header: 


ICBS Users This fleld contains the number of users for a 
particular ICB In a task processor. 


ICBS Flags Not used. 

!CBS CST BASE Contains the first byte of the ICB_ file 
descriptor. This is the starting location of 
the ICB file. 

ICBS CST Limit ContaIns the last byte of the ICB_ file 
descriptore This Is the ending location of the 
ICB file. 


PCB ANALYSIS 


This area contains information regarding the programs assigned to a specific task processor. The fields 
in this section are the same as those of the ICB Analysis area. 
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TCB ANALYSIS 


The standard Block Header fields are followed by a TCB descriptor and a segment table. 
TCB Descriptor 


Priority This fleld Indicates the external priority of 
the user task, where 


aoia=C 
@02@ = 8B 
a0se@ =A 
! Seg Interpreter segment number. 
| Off Offset into the Interpreter segment. 
CST Size Size of the code segment table. 
CST Sector Offset of the code segment table. 
IST Size Size of the Interpreter segment table. 
IST Sector Offset of the Interpreter segment tabte. 
DST Offset Offset Into the data segment. 
PPA Size, Size and offset of program parameter areae For 
PPA Sector COBOL, this area Is the COP table. Not used by 
MPL. 
CH Return Not used. 


Data Stack Pointer Job-related parameters. 
thru 
Control! Stack Limit 


Flags The flag bits are: 


MSB 7.86 Used for thrashing detection 


5 Not malntained 
4 DS or DP condition 
3 Suspend 
2 Save data structures 
1 Remove 
LSB 0 Long walt 
Stntmask Not maintained. 
FCM 
SPSA Seg S-program start address segment number and 
and displacement. 
SPSA Off 
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TCB SEGMENT TABLE 


The layout is as in a PCB. The disk address field points to the offset within the appropriate disk file 
from where the data segment is to be loaded. This could be the VM file, the code file, or a ‘‘zero 
fill,’’ depending on the current state of the program. FIB segments are replaced by FPB segments. The 
FPB is CMS standard. These are listed after the TCB segment table. The STE number is an Analyzer- 
computed field to cross reference the FPB to the segment table. 


JOB QUEUE 
Contains status information for each task. 


OS REQUEST TASK 


Contains information similar to an output mailbox that has not been serviced yet. 


TERM TASKS TASK 

Contains information regarding tasks waiting to be terminated by job management. 

READY QUEUE, TERMINATING QUEUE, LOCKED QUEUE 

The task processor has three queues: Ready Queue, Blocks Lock (waiting), and Terminate Queue. A 
Hehe to the head of these lists is in the pointer fields. Each queue is in prioirity order, highest to 


COMPUTING AMOUNT OF SPACE OWNED BY A TASK 


A task uses memory for a task record, PCB, TCB, and present segments. The size of these areas can 
be found as follows: 


Teck raccs dic 
fasK PFocoru s 


PCB size stze of PCB record plus present segments. 


Use the "PCB ID" field In task to find PCB 
record. Size fleld of preceding "space" record 
contains the size of the PCB (Including block 
header, space record, and segment descriptors). 


Segment size = size specified In the segment descriptor If 
the absent bit (bit 6 In flag) Is not set. 
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vT-ol 


MAILBOX TEXT = 16 BYTES 
VALID VALUES IN BYTE 14. 


ADVERB OF VARIABLE LENGTH | FF oa CMS COMMUNICATE 


cms SEG | LINE NO.IF COBOL 
EVENTIN HEX NOTAPERICABTS ———| $3 SHOGEATHE ia ek OFFSET 
cms 
EVENTINHEX ————— NOT APPLICABLE + 


ED2650 


———— NOT APPLICABLE ee eee eee 


YIELD ON INTERRUPT 


70 ees 
71 Lae FOR GETSEG 
15 = 


YIELD FOR SYS-MESSAGE 
(USED ONLY BY SORT) 


EACH 4-BYTE ENTRY NOTE: 


NOTE THAT THE CMS COMMUNICATE WILL 


SEG APPEAR IN THIS FORM IN THE TP OUTPUT 
TYPE FILE-ID MAILBOX (FIRST 16 BYTES ONLY). 


07 = DATA | | work | 

| Brock | 

08 = CODE | | wo | 
09=INTERP | 


Figure 10-5. Task Record Text 


SECTION 11 
DISK MANAGEMENT 


INTRODUCTION 


Details concerning the B 900/CP 9500 disk subsystem are provided in this section of the dump. The 
configuration and physical status of all disk drives attached to the system can be ascertained, as well 
as commands handled by the disk drives. The following structures are contained in this section: 


TASK STACK - information relating to internal disk processor’s operation 
State Save Area 

Pointers to structures within the disk processor’s memory 

PORT TABLE - configuration of I/O channels 

COMMAND TABLE- I/O command data 


DRIVE TABLE - containing actual drive status 
INITIAL DUMP ANALYSIS 


If the disk processor encounters a hardware error causing the processor to freeze, the Hex display indi- 
cates ‘‘F00000’’ on the lower banks of lights. Two common causes of a frozen processor are the system 
disk going ‘“‘NOT READY,”’ and the disk processor detecting a memory parity error. In these 
situations, a ROM/PROM dump needs to be taken, followed by an examination of the Disk Manage- 
ment section of the dump. 


The important areas to interrogate in this section of the dump are the DRIVE TABLE, the COM- 
MAND TABLE, and the PORT TABLE. The DRIVE TABLE entries provide the result status of the 
last I/O command issued on all drives attached to the system. Any I/O errors are indicated in these 
entries. The last I/O performed on each disk drive is identified in the COMMAND TABLE. Lastly, 
the PORT TABLE defines the existing disk drive configurations. 


If a failure has been detected within the disk processor, then the State Save Area needs to be studied. 
The error number identifies the cause of the failure. If this field has a value of @00@, then a hardware 
error has occurred. Further analysis of the State Save Area as outlined in section 8 of this manual 
will assist in identifying the type of failure detected. 


Following is a detailed description of the tables found in the Disk Management Section. 
FIRST FIELDS 
The first items encountered in the Disk Management section of a dump are explained as follows and 


shown in figure 11-1. 


OS PAGE This Is a 9-byte fleld, of which the first two 
bytes (reversed) are the bus and page of the OS 
Processor, with the IC enable bit set. 


OS INTERFACE AREA This Is the base address of the disk/0S 
processor Interface area within the OS processor 
page 0. 
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Rake aKRAKAARAALRANAAK ALARA KHARKS 


earake DISK MANAGEMENT ®kaenan 
PREREAREAPAAEREERARRAAERE RARER 


OS PAGE 
OS INTERFACE AREA 


STATE SAVE AREA 
STATE SAWE AREA ADDRESS 
ERROR NUMBER 
ACTION ID 
ACTION NAME 

Mt 

WR 

M2 

B32 

MAX 

MXA 


AD 

TOP OF STACK 

TGP OF XSTACK 

@nS ON STACK 

2ND ON XSTACK 

3RD ON STACK 

3RD CN XSTACK 
BOTTOM OF STACK 
BOTTOM OF XSTACK 
IC - ERROR STATUS 
IC — STATUS WORD 1 
IC — STATUS WORD 2 
IC - STATUS WORD 3 
IC - STATUS WORD 4 
IC — STATUS WORD 5 
IC — FIRST ERROR REG 


DP SIZE 

CURR TASKS 
MAX DRIVES 
TASK INFO PTR 
TASK STACK PTR 
MGR STACK PTR 
PORT TBL PTR 
CMD TBHL PTR 
DRIVE TEL PTR 
RD AVAIL PTR 
RD INUSE PTR 


0021 3au0 GOOO “000d 00 
£366 


3AUG 


FF END OF LIST EXCEEDED 


G000 C000 0000 0000 


FREE FREE 


Figure 11-1. Sample Disk Management Section Initial Entries 


11-2 


TASK INFORMATION 


STATE SAVE AREA 


DP SIZE 


CURR TASKS 


MAX DRIVES 


TASK INFO PTR 
thru 
DRIVE TBL PTR 


RD AVAIL PTR 


RD INUSE PTR 


Refer to the State Save Area In the OS Processor 
section, section 8. 


This fleld is a 2-byte entry, reversed, that 
contains the number of bytes of code and data In 
use by the DSCP. Additionally, if the DFCM Is 
connected to the system, this fleld Is the base 
of a 5,760-byte buffer used to transfer data 
to/from the DFCM. 


This field fs a i-byte entry that represents the 
drive that was told to execute a command on the 
last pass through the drive scheduler. It does 
not represent the drive that might be currently 
executing a command. 


This fleld Is a I-byte entry that represents the 
maximum number of drives that the DSCP will 
allow for the amount of memory present. In 32K, 
a0@ drives are allowed; In 64K, @10@ drives are 
al lowed. 


These fields are 2=byte reversed entries 
pointing to the named structure. 


This fleld Is a 2-byte reversed entry pointing 
to the start of the available result descriptor 
space. @FFFF@ means that no space Is available. 


This fleld Is a 2-byte reversed entry pointing 
to the start of the result descriptor space that 
currentiy contains vaiid resuit datas é&FFFFE@ 
means that no space Is in use. 


The Task Information Table consists of up to 16 5-byte entries. If the DSCP memory contains 32KB 
on page 0, there will be eight entries; otherwise, the Task Information Table will contain 16 entries. 


Each entry of this table corresponds to a drive: entry 0, drive 0; entry 1, drive 1; etc. 


Each entry of the table has the format: 
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Byte 


Length Meaning/Contents 


1 Status: @00@ = Runable 

@01@ = Waiting 1/0 

@FF@ = Idle 
2 Task stack base address, two bytes, reversed 
2 "L" register value used as a polnter Into 


the task stack 
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STATUS NOTES: 


Runable implies that the command will be given control on some future pass through the task sched- 
uler. At this point, the command may be complete, and the OS still needs to be given the result, or 
the command may not even be started. For a CMS type command (see Commands), it may mean that 
an intermediate I/O operation is complete. 


Waiting I/O implies that the task is executing a command on the drive, and that the command is cur- 
rently in progress. 


Idle is self-explanatory. 


Refer to figure 11-2 for a sample Task Information Entry and an explanation of the decoding. 


TASK INFORMATION 56C3 FFEB 5600 00 
5608 FF17 581B 58 
56CD FF43 5900 DO 
5602 FF6F 5A79 5A 
5607 0198 5B0F 5B 
560C FFC7? 5C00 00 
56E1 FFF3 5D00 00 
56E6 FF1F 5FOO 00 


Example of DecodI ng 


56C35 FFEB 5600 00 


i coe 


IDLE 7” BASE ime L REGISTER 


ADDRESS OF 


56EB 


Figure 11-2. Sample Task Information Entry 
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TASK STACKS 


The task stacks are 300-byte entries, one per drive, and represent the call and return stack for the task. 
Each entry on the stack is a 2-byte reversed address which is used to transfer control to the routine 
pointed to by the address. Additionally, temporary data is put onto the stack for convenience purposes. 
The task information ‘‘L’’ register value points to the next available 2-byte task stack entry. All task 
stack entries are ‘‘POP’’ed and ‘‘PUSH’’ed in a first-in-last-out (FILO) manner. 


TASK STACK DATA FOR DISK PACK DEVICES 


The disk pack devices use the task stack for additional command parameters and data. The portion 
of a task stack used by a disk pack device is pointed to by the Drive Table for the disk pack device 
(see Drive Table, Disk Pack Devices, MY.L Field). The format of the Task Stack Pack Area is shown 
below. (Note: add the value of the MY.L field from the Drive Table to the ‘‘byte’’ offsets below to 
arrive at the memory address of the data.) 


Byte Length Meaning/Contents 


Buffer fragment length 

Buffer fragment page 

Buffer fragment base 

Total transfer size. Note: Orive Table buffer 
size = number of bytes transferred so far 

8 1 Block level transfer - HSTLTA block types 
currently expected. 


@0@ = NSBR block expected 
@40€ = NSBW block expected 


@20@ = TD block expected, but not required 
9 1 Block level transfer - HSTLTA block types 
allowed after a transfer delay occurs 
@0@ = NSBR block allowed 


A rn O 
NNN NY 


840@ = NSBW block al lowed 

10 2 Address of Read Transfer routine for this 
command 

12 2 Address of Write Transfer routine for this 
command 

14 4 Search Command Hit Sector address 

18 2 Search Command Hit Sector offset 

20 14 A copy of the original values of 


bytes 0 through 13 to be restored 
to bytes 0 through 13 If a retry Is 
required 


MANAGER STACK 


This is a 50-byte entry that contains run-time pointers and data for the Scheduler and Task Manager 
routines. The format of this structure is the same as for the task stacks. However, only the manager 
routines use it. 
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PORT TABLE 


The port table entries each describe a port on the DSM processor. The entries consist of 43-byte 


elements, with the following format: 


Byte Length Meaning/Contents 

0 1 Controller ID 

1 1 The O-relative drive number of the first 
drive on the port 

2 1 The number of drives on the port. Note the 
following relationship: first drive plus 
number of drives = the first drive on the 
next port 

3 40 Control ler-dependent parameters 


CONTROLLER IDENTIFIERS 


The following values may be found in the Controller ID field of the Port Table: 


1D CONTROLLER TYPE DRIVE TYPE PORT ASSIGNMENT 

@52@ Standard disk In drive Any port 3 thru 7 
Host Control! ler Table 

@60@ 1 drive 1MB B9489-1/11 Any port 3 thru 7 
BSMD 

@62@ #1 drive cartridge disk B9480-11 Any port 3 thru 7 
100 TPI 

a64@ 1 drive cartridge disk B9481-11 Any port 3 thru 7 
200 TPI 

@66@ 1 drive cartridge disk 89480-21 Any port 3 thru 7 
100 TP! 

@68@ 2 drive 1MB B9 489-12 Any port 3 thru 7 
BSMD 

@6A@ 2 drive cartridge disk B9480-12 Any port 3 thru 7 

@6C@ 2 drive cartridge disk B9481-12 Any port 3 thru 7 

@6E@ Z drive cartridges disk 89480-12 Any por? 5 thru 7 

G6Fa@ 2011 fixed B9493-18/37 = Any port 3 thru 7 

@1@ DMITR N/A Port 2 

@8@ DFCM N/A Port 7 

@®A@ DISK PACK DDP IN ORIVE Any port 3 thru 7 

TABLE 

@FE@ OS PORT N/A Port 0 

@FF@ N/A N/A Port 1, Not used 

@FF@ N/A N/A Any port that does not 


CONTROLLER DEPENDENT PARAMETERS 


contain a device 


Some controller firmware routines keep port-dependent information in the Port Table. The firmware 
for host and disk pack devices use this area of the Port Table. The formats are as follows: 
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Host Device Port Table 
If the Port Table ID is @52@, the following information applies: 
Byte Length Meant ng/Contents 


Current hardware command string length 
Current hardware command 

Current port relative drive 

Current sector address 

Current 1/0 length 


i i 


If byte 5 is Search (@A8@) then: 


7 1 Search NULL character 
8 1 Search type (greater than, less than, etc.) 
9 4 Search starting sector address 
13 H Tag of fset within firsT sector 
14 1 Search tag length 
15 2 Search 1/0 length 
For all commands: 
7 1 Current port relative drive 
18 1 Port busy flag (FF = true, 00 = false) 
19 1 Prepare-To-Load (PTL) flag 
20 1 Power-On-Reset (POR) In progress flag 
21 2 Base address of the first drive table for 


the first drive on this port 


Disk Pack Port Table 
If the first byte of the port table entry is @8A@, the following information applies: 
Byte Length Meaning/Contents 


"AD" register setting for this port 
Complement of byte 4 

Current active port relative drive 

Address of status byte for this port 

(89387 status Is reflected as "PMA") 

9 1 Subsystem Poll In Progress flag 

10 8 Drive states (drive 0 to 7), 1 byte each 
a0dé = Idle 

@01@ = Queued, command ready to send 
@FF@ = In progress, B93B7 has the command 


~~ aun 
N= ao 


COMMAND TABLE 


This area is used to store the command information fetched from the OS processor. Each entry of 
the table is 18 bytes, and is indexed by drive number. All disk processor commands and layout are 
described in the following paragraphs. A sample command table section is shown in figure 11-3. 
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COMMAND TABLE ENTRY 
LOMMAND TABLE ENTRY 
COMMAND TABLE ENTRY 
COMMAND TABLE ENTRY 
COMMAND TABLE ENTRY 
CUMMAND FABLE ENTRY 
LUMMAND TABLE ENTRY 
LCUMMAND TABLE ENTRY 


6143 0400 0000 D000u OGN0 vOood 0000 O0uu Ouud Jo0N 
61B5 vg00 0000 0000 9009 0000 yO0d OOu0 0000 u900 
6107 0000 G000 9000 Gu0d 0000 YOOX 0000 O0u0 0000 
6109 O0G00 0000 0000 0000 v000 0000 O00u Ovud QUOD 
61EB 01/00 6000 0300 0060 suD0 8AC1 0200 OYFF FFFF 
61FD 0000 v009 DOu0 0009 Ou00 v0Od O9V0 Ou0d VOd0 
620F G@G00 0000 0000 0000 6000 v00d 0000 Ouut Gud 
6221 0400 0000 00uG 0000 0000 000u 0000 Ouvd g000 


“OW £&N FO 


Figure 11-3. Sample Command Table Section 


COMMAND RESULTS 


The results of a command are relayed to the OS processor in three ways: 1) through Command Status 
(see Drive Table), 2) through result descriptors (see Drive Table), and 3) through result parameters. 


The semantics of Command Status are explained in the Drive Table description. 
If a disk device error occurs, the error information is maintained in a result descriptor structure, and 
the unique result descriptor identifier is returned in the last three command parameters, bytes 16 


through 18. 


The result parameters are command dependent, and are returned to the OS processor in bytes 10 
through 15 of the command parameters. 


GENERAL COMMAND LAYOUT 
There are five types of system commands, as follows: 
1. Read. 
2. Write. 
3. Search. 
4. Initialize. 
5. Lock/unlock door. 


Some commands have a specific format, but in general, they have the following format. Any deviations 
from the general format are identified in the individual command descriptions. 


Byte Length Meaning/Contents 


1 1 Opcode 

2 2 Buffer fragment size 

4 2 Buffer fragment page 

6 2 Buffer fragment base 

8 2 Total buffer size: note the fo! lowing 
relation: If buffer fragment size equals 
total buffer size, then the transfer Is not 
to/from fragmented buffers, but contiguous 
memory « 

10 3 Starting sector address. 


COMMAND TYPES 


There are two types of commands: System and CMS. System commands require no preliminary pro- 
cessing before being executed by disk drive controller firmware. CMS commands are commands that 
manipulate disk directory structures, and may be made up of many system commands (READ, 
WRITE, and SEARCH). The commands are as follows: 


Opcode Type Description 

4a00a SYS Read Data 

ecie SYS Write Data 

026 BD 65) Write Data and Check data or data parity 

@03@ SYS Search less than tag argument 

@04@ SYS Search less than tag argument and read 
hit sector 

6056 SYS Search Greater than tag argument 

a06e@ SYS Search greater than tag argument and read 
hit sector 

@07@ SYS Search equal to tag argument 

awe SYS Search equal to tag argument and read hit 
sector 

ene SYS Search tess than or equal to tag argument 

@0Ae@ SYS Search less than or equal to tag argument 
and read hit sector 

@0Be SYS Search greater than or equal to tag 
argument 

a@0ce sys Search greater than or equal to tag 
argument and read hit sector 

aoDe SYS Initialize 

@0Ee SYS Lock Door 

a0Fe SYS Unlock Door 

108 sys Read Sector Relocation Map 

e1ie SYS Read Device Statistics 

@12@ SYS Clear Device Statistics 

aise SYS Read Result Descriptor 

ai4e CMS Read Disk File Header (DFH) 

e156 CMS Write DFH 

a16e@ CMS Locate pseudo pack 

e174 CMS Locate file 

aise CMS Locate file and read DFH 

a19e CMS Create temporary entry 

alae CMS Allocate file area 

@iBe CMS Crunch file 

aice CMS Purge file 

4268 CMS Power off disk 

42764 CMS AVR disk with label read 

ee SYS Initialize disk pack cylinder data 

ene SYS Verify disk pack cylinder 

@2A@ SYS Relocate disk pack bad sector 


READ 


READ transfers data from a disk device to memory. READ uses the standard command format. 
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WRITE 


WRITE transfers data from memory to a disk device. WRITE uses the standard command format. 


WRITE WITH DATA OR DATA PARITY CHECK 


This command performs a WRITE operation, and then reads the data back from disk to check it. 
If the device is a 3/6 BSMD, then the data parity is checked. If the device is a cartridge disk device, 
then the data read back is compared to the data written. If the device is not one of these types, the 
command defaults to a normal write. This command uses the standard format. 


SEARCH 


The SEARCH commands search the disk for the occurrence of a tag with a given relationship to a 
tag argument. Search uses the standard command format with the following changes: 


Byte Length Meaning/Contents 


8 2 Number of sectors to search; two bytes, 
reversed 

10 3 Starting sector address 

13 1 Key length 

14 1 Key of fset within tag argument 

15 1 Tag argument length 


Search returns the following result parameters: 
Byte Length Meaning/Contents 


10 3 Hit Sector address 
13 1 Offset of Hit Tag within the Hit Sector 


INITIALIZE 
INITIALIZE is valid for cartridge type devices and disk pack devices. 


DISK CARTRIDGE DEVICES Initialize for disk pack devices causes sector 
addresses to be written to one cylinder of the 
device, and the sector data flelds written with 
a data pattern. The command parameters are as 
fol lows: 


Byte Length Meaning/Contents 


8 2 Number of tracks to Initlalize 
10 3 Starting sector address of starting track 
DISK PACK DEVICES Initialize for disk pack devices causes 


sector addresses to be written to one cylinder 
of the device, and the sector data fields 
written with a data pattern. The command 
parameters are as follows: 


Byte Length Meaning/Contents 


10 3 Starting sector address of cylinder 
13 2 Data pattern, 2 bytes reversed 
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LOCK DOOR 


This command causes the door of a 3/6 BSMD device to be locked. All command parameters are ig- 
nored except the OPCODE. 


UNLOCK DOOR 


This command causes the door of a 3/6 BSMD device to be unlocked. All command parameters are 
ignored except the OPCODE. 


READ RELOCATION MAP 


This command transfers the relocation map of host (SDHC) type devices to the buffer. This command 
uses the standard format. 


READ STATISTICS 


This command transfers the statistics of host (SDHC) type devices to the buffer. This command uses 
the standard format. 


CLEAR STATISTICS 


This command clears the statistics of host (SDHC) type devices. All command parameters are ignored 
except for the OPCODE. 


READ RESULT DESCRIPTOR 


This command finds the correct result descriptor and transfers it to the buffer. The command 
parameter format is as follows: 


Byte Length Meaning/Contents 


10 1 Result descriptor IdentI fier 


READ DFH 


This command returns an adjusted DFH to the OS processor buffer. The The command parameter 
format is as follows: 


Byte Length Meaning/Contents 


10 2 DFH directory Index 


WRITE DFH 


WRITE DFH writes the actual header to disk when given a directory index and an adjusted DFH in 
the buffer. The command parameters are the same as for READ DFH. 


LOCATE PSEUDO PACK 
LOCATE PSEUDO PACK searches the PPIT on a given unit for a 7-byte pack ID and returns the 


pack tag and logical unit number. The command parameters are the standard format. The result pa- 
rameters are as follows: 
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Byte Length Meaning/Contents 


10 1 Pack tag 
11 1 Logical unit number 


LOCATE FILE 


LOCATE FILE searches a Directory Name list for the 13-byte File ID in the buffer and returns the 
directory index of the DFH if the ID is found. The command parameters are the standard format. 
The result parameters are as follows: 


Byte Length Mean! ng/Contents 


10 2 DFH directory Index 


LOCATE HEADER 


LOCATE HEADER is identical to LOCATE FILE, except that a successful LOCATE will return an 
adjusted DFH. The command parameters are the standard format. The result parameters are the same 
as LOCATE FILE. 


CREATE TEMPORARY ENTRY 
CREATE TEMPORARY ENTRY searches the Name List for an available entry, updates the corre- 


sponding header entry, and returns the header and directory index if the disk had an available entry 
to use. The command parameters are the standard format. The result parameters are the same as LO- 


CATE FILE. 
ALLOCATE AREA 
ALLOCATE AREA allocates an area for the specified DFH. The command parameters are as follows: 


Byte Length Meaning/Contents 


10 2 Directory Index 
12 2 Area size In sectors 
14 1 Area number 


The result parameters are as follows: 
Byte Length Meantng/Contents 


10 3 Starting sector address of area Just al! located 


CRUNCH FILE 


CRUNCH FILE alters the specified DFH to return excess space to the non-file directory. If the last 
area is not on the specified unit, only the file pointers are updated. The command parameters are the 
same as for READ DFH. 


PURGE ENTRY 


PURGE ENTRY returns the specified directory entry to the available list, and returns all disk space 
allocated to the file on this disk to the non-file directory. The command parameters are the same as 
for READ DFH. 
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POWER OFF DISK 

This command causes the disk to be logically powered off. The following steps are taken: 
1. The door is unlocked (if applicable). 
2. The Label Integrity flag is reset. 
3. The tables for the drive are initialized. 

All comménd parameters are ignored except the OPCODE. 

AVR DISK 


This command performs the automatic volume recognition functions, such as label verification, setting 


the integrity flag, and reconectructinn. Tha rammand vn rameters are the standard format. 


See ee aid, Saar Rw wwaaee weaves SEN NU ELARIULIU pa 


INITIALIZE CYLINDER DATA FIELDS 


This command is valid for disk pack devices only. This command writes the sector data fields of the 
specified cylinder with the specified data pattern. The command parameters are the same as for the 
INITIALIZE command for disk pack devices. The result parameters are as follows: 


Byte Length Meaning/Contents 


13 3 Sector address where the first/worst error 
occurred (If an error occurred) 


VERIFY CYLINDER 


This command is valid for disk pack devices only. This command verifies the cylinder data fields and 
error protection codes of the specified cylinder. The command and result parameters are the same as 


for INITIALIZE CYLINDER DATA FIELDS. 
RELOCATE BAD SECTOR 


This command is valid for disk pack devices only. This command causes the specified sector to be 
relocated to a spare on the cylinder. The command parameters are as follows: 


Byte Length Meaning/Contents 


10 3 Sector to be relocated 
13 2 Data pattern 


DRIVE TABLE 


The drive table holds all data relative to its corresponding drive. The drive table is divided into two 
parts: the general data area and the device-dependent data area. The general data area is standard 
among all drives. The device-dependent area is different for each of the three types of drives: disk 
cartridge, host, and pack. Each of the areas is described as follows. 
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DRIVE TABLE LAYOUT 


Byte Length Meaning/Contents 


1 1 Drive Status (Refer to Table 11-1) 

2 1 Orive Identifier (Refer to Table 11-2) 
3 1 The Port for this Orive 

4 1 DFMC Participating Flag 

5 2 Command Entrance Routine Address 

7 1 Command Status (Refer to Table 11-3) 
8 1 Monitor Status (Refer to Table 11-3) 
9 1 Command Retry Count 
10 1 Result Descriptor Index 
11 2 Result Descriptor Size 
13 15 Command Parameters (Refer to Command Table) 
2B 210 Device-Dependent Data Area 

Table 11-1. Drive Status 

BIt Set Meaning Reset Meaning Notes 
rf?) Ready Not Ready 

1 Write Inhibit Not Write Inhibit 

2 Tempor ar I ly Not TNA * 

Avattable (TNA) 

3 Disk In Danger Disk Not In Danger 

4 Disk Expiring Disk Not Expiring 

5 Mandatory Interrupt Not Mandatory Interrupt 

6 Spare 

7 Spare 


*TNA applles to 3/6 devices only, and Implles that the door of the 
other drive Is open. 


Bits 2 through 5 are for SDHC devices only. 
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The drive IDs declare the type of drive present, and sometimes match the 


Table). 
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Table 11-2. Drive Identifiers 


Identifier Orive Type Drive Name Controller Type 
453@ B9 49 3-20 20 MB 211 FD SDHC, @52@ 
654e@ B9 493-80 80 MB 211 FD SDHC, @52@ 
@56@ B9489-21/23 3/6 BSMD 2DR SDHC, @52@ 
@57@ B9 493-40 40 MB 211 FD SDHC, #528 
8608 B9489~-1/11 1MB BSMD 1DR SAME 
4626 B9480~11 100TP! CART 1 OR = SAME 
e64e@ B948 1-11 200TP! CART 1 DR SAME 
e668 B9 481-21 100TP! CART 1 DR = SAME 
468 @ B9489~12 1MB BSMD 2 DR SAME 
@6Aa 8948 0-12 CART 2 ORIVES SAME 
e@6ce B9 489-12 CART 2 DRIVES SAME 
@6E6@ B948 0-22 CART 2 DRIVES SAME 
@6Fe B9 48 3~ 18/37 2011 FD SAME 
es @ 205 DPD DPIOC, @8Ae 
a78@ 206 DPD DPIOC, @BA@ 
668 @ 207 FD DPIOC, @BA@ 


Table 11-3. Command Status Semantics 


COMMAND STATUS 


Value 


00 
ot 
02 


03 
04 
05 


MONITOR STATUS 
Value 


00 
01 
02 
03 
04 
05 


06 
o7 
08 
o 


Meaning 


Controller error - ftnternal to DP 

Command successful 

Command Incomplete, legal unsuccessful result 
(1-e@., SEARCH tag not found) 

Device error = command aborted 

Spare 

1/0 descriptor error 


Mean! ng 


No error 

Seek timeout 

Head off cylinder (Seek error) 

Sequence error - Internal to DP 

Disk data/address parity error 

Disk address not found 

illegal address In 1/0 descriptor 
Status word error - Internal to DP 

Data error In COMPARE 

Attempt to write to write-inhibited disk 


port controller ID (See Port 


11-15 


DEVICE DEPENDENT DATA AREA 

The byte offsets given here are a continuation of the offsets found in the general data area description. 
The values of some of the fields in the Drive Tables can be found in the discussion of the specific 
device type. 

Disk Cartridge 


The following table defines the remaps of the device-dependent data area for disk cartridge devices. 


Byte Length Meaning/Contents 

2B 2 Pointer to the Next Phase routine 

30 2 Total buffer size 

32 2 Fragment size 

34 2 Fragment page 

36 2 Fragment base 

3% 2 Least significant two bytes of the current 

sector address 
40 1 One Buffer flag 
4} 1 Most significant byte of the current sector 
address 

42 1 Last Transfer flag 

43 1 Current retry count 

44 1 Dual 2011 flag 

45 1 Sectors per track 

46 1 Compliment of the "AD" register setting 
47 1 Current controller status 

48 1 Opcode 

49 1 Drive address on the port 

50 1 Current Search size 

51 1 Current Search flags 

52 1 Current Search of fset 

53 1 Current Search Hit Sector address 

54 2 Current cylinder number 


HOST DEVICES 


Byte Length Meaning/Contents 


2B 180 Search Hit Sector buffer 

208 4 Search Hit address 

212 1 Search Hit offset 

213 1 Hardware opcode 

214 2 Fragment size 

216 2 Fragment page 

218 2 Fragment base 

220 2 Address of Command Complete routine for this 
command 

222 2 Address of Transfer routine for this command 

224 2 Transfer length 

226 1 211 type device flag 

22] 1 One buffer flag 

2B 1 Address of drive on port 
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If the’ Search Hit Sector buffer contains 
can be found in the DAR: 


Byte 


22 
230 
231 
232 
236 
237 


Byte 


DISK PACK DATA 
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Byte 


60 


Length 


1 
1 
1 
4 
1 
1 


Length 


Length 


NNN = |] NY ee wen ew aay ew oo 


Meaning/Contents 


SDHC last status 

Last Class 2 Status Interrupt 

Error mask 

Hardware status, DC status bytes 1, 2 and 3 
Port Polling flag 

Drive status for Polling process 


the device attribute record (DAR), then the following fields 


Meaning/Contents 


DAR Check Byte 1 

DAR Check Byte Z 

DAR Confidence Test results 
Drive ID bytes 

DAR for Drive 0 

DAR for Drive 1 


Meaning/Contents 


@®0@, Command Block Type byte 

@0C@, Command Block Count byte 

Current 89387 Opcode 

Current B9387-Relative Unit 

Current command variants 

Current 1/0 fength 

Current sector address 

1@, Write Block Type Byte 

Write Block count byte 

Search Null Character 

Search Relationship 

Search Tag Offset within sector 

8008, not used 

Reason for last transfer delay 

@00@, not used 

Last short result descriptor Info byte 
Value of "L" register at command start 
MY.L, the current value of the "L" register 
Potnter to the Port Table of the port to 
which this drive is connected 

Address of the current result descr I ptor 
for this drive 

Result descriptor tdentifier 
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RESULT DESCRIPTORS 


There can be two result descriptor lists: AVAILABLE and INUSE. The AVAILABLE list contains all 
result descriptors not containing data, and the INUSE list has all the result descriptors containing data 
when the dump was taken. 

The INUSE list can be expected to have all result descriptors that are currently being used to store 
error information. Typically, this list is empty, as data from INUSE result descriptors would have been 
fetched by the OS processor, and the descriptors would have been returned to the AVAILABLE list. 


A result descriptor is divided into two parts: control information and data. The control information 
is used to maintain the result descriptor lists, and the data portion contains the drive-related failure 
data. 


CONTROL INFORMATION 


The format of the CONTROL INFORMATION is as follows: 


Name Byte Length Meaning/Contents 


LINK 1 2 Link to the next RD on this list; @FFFF@ 
Implies that the end of the list has been 
reached. 

INDEX 3 1 Indexes This 1s the unIque RD identifier. 

DRIVE 4 1 Drive. !f the RD Is avallable, this flald 


is @FF@; otherwise, It Is the drive number 
of the drive whose data Is In the RD. 


RD DATA 


The RD Data portion of a result descriptor contains the information describing the error, and the for- 
mat of the data depends upon the type of device that owns the RD. 


Disk Pack RD 


Byte Length Meantng/Contents 


1 1 B9387 Opcode 
2 1 89387-relative unit number, 0-7 
3 2 B9387 command descriptor variants 
5 4 Starting sector address 
9 4 1/0 operation length 
3 1 Last byte read from the 8900 disk pack DDP 
4 1 Last byte expected to have been read from the 
DDP - see note 4 
15 1 ODP status after last byte read from DOP 
16 1 B900 error number - see note 1 
1 B9387 longitudinal parity byte 
1 Host-computed longitudinal parity byte 
19 1 Last ClO command sent - actual value 
1 Status response to last ClO command 
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21 
22 
23 
24 


Notes: 
1. 


01 


Direction of transfer - see note 2 

B9387 long result descriptor byte 0 
89387 long result descriptor byte 1 

44 B9287 long result descriptor bytes 3 - 45 


— oe 


Bad vertical parity error on B900 Input transfer 
Bad longitudinal parity error on B900 Input transfer 
DDP 2.0-second timer expired before 89387 response 
Host block count different from B92387 block count 
on Input or output transfer 

Software 2.3-second counter expired while walting 
for B9387 response; DDP timer failed 

Incorrect Block Type on 8900 Inout transfer 

Count byte did not correspond to type byte on 8900 
input transfer 

From B900 DDP to 8900 DSM processor 

From 8900 DSM processor to B900 DDP to DSM processor 


This Is the actual Hex value sent to the DDP 
If the error number Is 06 (Bad Type Byte), then this fleld 
has the following meanings: 


ot 


02 
03 
04 


Expected TD, long RD, short RD, READ OK, READ retry, 
READ correction, or READ uncorrectab le 

Expected TD, long RD or short RD 

Expected long RD or short RD 

Expected TD during SEARCH 


NULL RESULT DESCRIPTORS 


A result descriptor is termed a ‘‘Null RD’’ when it contains error data, but the error occurred before 
a command was sent to the drive. An example of this is a mandatory interrupt on a 3/6 device, which 
occurs when the BSMD is placed in the drive and the door shut. In these cases, the status of the device 
changes from Not Ready to Not Ready-Mandatory Interrupt. In order for the OS to display the man- 
datory interrupt message with device status, the DSCP places the status in a NULL RD, and changes 
the device status in the OS. The OS sees the status change, and issues the READ RESULT command 


to the DSCP, with the unique result descriptor identifier parameter as @FF@ (hence, NULL). This 
causes the DSCP to return the correct RD. 


A NULL RD in the INUSE List is indicated by an index value greater than @E0@. 


DISK CARTRIDGE DRIVES DATA CONSTANTS 


Disk cartridge constants are: 


Fleld Name Values Meanings 
Search Flags 01 Dual search required 
02 Pattern search 
Controller Status 00 Seek mode 
01 Command mode 
02 Idle 
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HOST DATA CONSTANTS 


Host data constants are: 


Field Name Values Meanings 
Current Hardware CMD @Ale Read 
ecea Write 
a/B@ Search 
@A2@ Read search result 
@ADe Read relocation map 
@AE@ Read statistics 
@A4@ Read DAR 
@A7T@ Read device status 
a@FDe Abort command 
@FBe Clear Statistics 
@F 28 Set Write Protect 
@F 4e Reset Write Protect 
ecia Unlock door 
@c2a Lock door 
ac4e Reset MTR 
Controller Status a00e Idle 
e0ie@ Pending 
@026@ Busy 
Error Mask 5@ Read After Write Check in 
progress, drive Write 
Inhibited 
wie Read After Write Check 
falled, Drive Write enabled 
B9387 Opcode adie Read 
a02e Write 
@03@ Search 
46108 Initialize 
eile Ver I fy 
4126 Inittallze Data Fleld 
@14e Relocate Sector 
4208 Test operation (soft poll) 
a6 0e Initialize C/W parameters 
Command Variants #0008 Walt for Seek to complete 
a0000e Do not walt for seek to 
complete 
Search Relations aoie Less than 
a02@ Equal to 
@03@ Less than or equal to 
4048 Greater than 
@05e Not equal to 
@06@ Greater than or equal to 
Task States e00e Idle 
aFFe In process 
acia Queued 
Blocks Expected ®0e NSBR expected 
@40@ NSBW expected 
208 TD expected 
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RECOMMENDED PROBLEM SOLVING PROCEDURES 


The Disk Processor can be involved in two types of system problems. These are a system hang and 
a @F00000@ clearstart. What follows are some recommended procedures for determining if the prob- 
lem is due to a hardware failure or a software failure. 

System Hang 


If the system hangs such that the time-of-day is still displayed, and if the processor displays continue 
to cycle, and the SPO transmits but does not respond, then perform the following steps: 


1. Take a ROM dump and run ROMCONVERT and the SYSANALYZER on the converted dump. 
2. Determine which disk is the system disk from the Configuration Table portion of the OS dump. 
3. Find the Drive Status field in the Drive Table for the system disk. 

4. If bit 1 of the drive status is set, meaning ‘‘Ready,”’ then the hang is due to some other factor. 


5. If bit 1 of the drive status is reset, meaning ‘“‘Not Ready,” then the hang might be due to a 
not-ready system disk. 


6. If the system disk is a SDHC 211 type device, then the Last Status field of the Drive Table 
contains the status that caused the disk to go not ready. 


7. Additionally, check the Result Descriptor Inuse list to see if an RD belongs to the system disk. 
If so, then this RD might contain more information about what caused the system disk to go 
not ready. 


8. If the system disk is a B9387 DPDC disk pack device, then find the Port Table entry for the 
DPIOC. 


9. Locate the address of the Status Byte field in the Port Table. 
10. Find the byte having this address in the disk processor Hex dump. 


11. If this byte is @00@, the system disk was made Not Ready because the B9387 went off line 
for one of three reasons: 


1) Someone placed the B9387 off line at the B9387. 
2) A cabling problem exists that caused the off-line signal to change states (noise, cable fell off). 


3) The B9387 controlware detected a temperature warning condition and will power, or has pow- 
ered, itself off. 


FOOOOO Clearstart 


A @F00000@ clearstart may be caused by three things: 1) a real hardware failure; 2) corrupted buffer 
memory buffer addresses; 3) corrupted I/O descriptor buffer address. To determine which of these 


Oa ee 


things occurred, perform the following steps: 
1. Take a ROM dump, run ROMCONVERT and SYSANALYZER on the dump. 
2. Locate the Disk Processor Save State Area. 
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3. If the IC error and status information indicate that a real error occurred, and MAX, MXA and 
MXB contain valid bus/page data, then a real error did occur at the IC First Error Reg address. 


4, Otherwise, if MAX, MXA, MXB do not contain valid bus/page data, then the problem is a soft- 
ware error. 
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SECTION 12 
BUFFER MEMORY 


INTRODUCTION 


Buffer memory is a global system resource used for file buffers, system I/O descriptors, data comm 
buffers, and queues. The amount of buffer memory is specified in the dependent portion of the SYS- 
COMFIG file. 


This section first discusses the technique for determining the amount of buffer space being allocated. 
This is followed by a detailed examination of the Buffer Memory section of a memory dump. 


The system uses the top page (or more) of OS memory as buffer memory. The system reserves buffer 
memory for the data comm buffers at WARMSTART. The amount reserved is that specified in SYS- 
CONFIG. The data comm buffers are analyzed and listed as part of the data comm section. No refer- 
ence is made to them here. 


The remainder is used as OS buffer memory. This must be at least 2048 (2K) bytes. Buffer memory 
can be a maximum of 1024 KB. 


Great care must be taken when assigning buffer memory. The performance of the B 900/CP 9500 can 
be seriously degraded if inappropriate values are specified in the buffer memory portion of SYSCON- 
FIG. If too much buffer memory is allocated for user programs, the MCP is forced to do more seg- 
ment overlaying. This is a result of not enough available MCP memory. If an insufficient amount of 
buffer memory is allotted for user programs, the programs will ‘‘wait on buffer space.’’ 


I/O BUFFER SPACE CALCULATION 


There are three ways to determine the amount of required buffer memory. The first method is to ex- 
periment with different buffer allocations until an optimum system performance is attained. This is 
an inconvenient procedure and possibly inaccurate. 


The second method is to load the system with a mix of jobs that will reflect a maximum throughput 
condition required by the user. At this point, a memory dump should be taken using the “GT MD” 
intrinsic. Examine the “AVAILABLE COUNT” field found at the beginning of the buffer memory 
section in the dump. Multiply this value by 195 (the size of each buffer plus descriptors). Remember 
to byte-reverse and convert to decimal the value in the field before multiplying. This result will indicate 
the amount of available memory. Subtract the amount of available memory from the amount specified 
in SYSCONFIG. This is the amount of required buffer memory. It is advisable to add a safety factor 
of 2K to this amount. 


The third and most accurate method requires knowing the block sizes and the number of buffers 
needed for each opened file on the system. With this information, use the following procedure: 
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1/O BUFFER SPACE CALCULATION 
250 plus the following equation for Opened Files 
1. Number of buffers divided by 4 rounded up, plus 


2. Block size divided by 180 rounded up, times the number 
of buffers, plus 


3. 1 If not Indexed, or 
3 If Indexed file, times 


4. 195 
Example #1 - Indexed file, 6 buffers, block size = 270 
1. 6/4 =1.5, r=2 
2. 270/180 = 1.5, r=2, 2x6=12 
3. 3 
44 2412+ 3217, 17 x 195 = 3315 bytes 


3315 
+250 


3565 1/0 Buffer space for 1 opened file 


Example #2 - Non-Indexed file, 1 buffer, block size = 180 
1. 1/4 = 025, r=! 


2. 180/180 =1, r=) 
Sect 
4. 1+14123, 3x 195 = 25 bytes 


25 file 
+250 base 


535 bytes 1/0 space for 1 open file 
Example #3 - Both 1 and 2 opened 
3315 for file 1 


25 for file 3 
+250 base 


3B50 bytes needed 
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OS buffer memory is organized in sections. Currently each section is 180 bytes in size (plus control 
fields). These sections are linked together in four categories: 


File table entries 

Key file table entries 

System I/O descriptors (Not yet implemented) 
Available sections 


These are controlled by a set of pointers located in the first 34 bytes of the buffer memory as follows: 


DA BUF POINTER POINTER 
AVAILABLE HEAD 
AVAILABLE TAIL 
FILE TABLE HEAD BYTES 
FILE TABLE TAIL BYTES 


4 BYTES 
4 
4 
4 
4 

KEY FILE TABLE HEAD 4 BYTES 
4 
4 
4 
2 


BYTES 
BYTES 


KEY FILE TABLE TAIL BYTES 
SYSIO DESC HEAD BYTES 
SYSIO DESC TAIL BYTES 
AVAILABLE_COUNT BYTES 


A sample of these entries in an actual memory dump is shown in figure 12-1. 


PT eT eT e Ce ereretetrr sri tittr ty T 
eenetnnk SUFFER MEMORY aennnnann 
Peete Tere eT ererrrereTertrart tT 


DA BUF POINTER POANTER 301 1360 
AVAILABLE HEAD 0501 6169 
AVAILABLE TAIL. 0301 1107 

FILE TABLE HEAD 0301 5265 

FILE TABLE TAIL 0301 oA@4 

KEY FILE TABLE HEAD EFFF FFFF 

KEY FILE TABLE TAIL FFFF FFFE 

SYS. 10 HEAD 0301 5060 

SYS Iu TAIL uS01 5060 
AVAILABLE COUNT 5F00 


Figure 12-1. Sample Initial Entry in Buffer Memory Section of a System Dump 


All but the Available Count are full system addresses, laid out as follows: 


7 0 7 0 7 QO 15 8 
( ) 1) ) } 
Page Bus Offset 


This layout is due to the byte reversal of the NBDS. 
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The exact usage of these fields is as tollows: 


DA_BUF POINTER POINTER Contains the address of the start of OS Buffer 
memory « 


AVAILABLE HEAD Contains the address of the first 180-byte 
section In the chaln of those sections that are 
avallable for use. 


AVAILABLE TAIL Contains the address of the last available 
section. 
FILE TABLE HEAD Contains the address of the first file table In 


the flle table chain. 


FILE TABLE TAIL Contalns the address of the last file table In 
the file table chaln. 


KEY FILE TABLE HEAD Contains the address of the first key file table 
in the key file table chaln. 


KEY FILE TABLE TAIL Contains the address of the last key file table 
In the key file table chain. 


SYS 10 HEAD Not malntalned. 
SYS 10 TAIL Not maintained. 
AVAILABLE COUNT Contalns the number of sections that are 


currently aval lable. 


SECTION LAYOUT 


Each section includes three parts: a preceding memory descriptor, the actual data, and a trailing de- 
scriptor: 


PRECEDING DESCRIPTOR 7 BYTES 


180 BYTES 


TRAILING DESCRIPTOR 8 BYTES 


ET2652 


There are two links, a preceding link and a trailing link, because PIMOVE expects the link to immedi- 
ately precede the section and to point to the next link, while the 1/O device controllers require the 
size of the next section and the link to follow the section, and the link to point to the first byte of 
the next section (for performance reasons). A sample section of a memory dump containing this infor- 
mation is shown in figure 12-2. 
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1b Oe 3 2 0 He OE TE He a8 aE aE ae nH HE ee PRECEEDING TRAILING 


FILE TABLE ENTRY CFTED FLAGS SIZE CINK SIZE LINK 
AER REE ANE  H PTET Meet erat ere PTT eri ri ir 
v1 B400 0@302A4CB 8400 030155606 


PRECEDING MEMORY DESCRIPTOR FORMAT 


The preceding memory descriptor contains three fields: 


FLAGS : 1 byte 
SIZE : 2 bytes 
LINK : 4 bytes 


These fields are used as follows: 


FLAGS 


SIZE 


LINK 
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Defines the current use of this section: 
@®0@ : Available section 
@01@ : File table section 
@02@ : File table extension section 
@03@ : Key file table section 
@04@ : Key file table extension 
@05@ : SYSIO descriptor table section 
4108 : Buffer section 


This entry contains the size of the section that 
follows. In this Implementation this field 
always equals 180. This fleld Is Implemented so 
that If the size of buffer sections change, code 
does not have to change. 


This entry contalns the address of the preceding 
descriptor for the next structure of a similar 
type, except for buffer sections where this IInk 
points to the next Iink In the preceding 
descriptor of the next sectlon of the buffer. 
The degree of linking varies according to the 
section type and use. Al! sections reserved for 
buffers are not linked together. Only those 
sections assoclated with a particular buffer are 
lInked. Conversely, all fille table sections, 
key table sections, avallable sections, and 
system 1/0 descriptor sections are IInked 
together» All fille table extension sections 
belonging to the same file table are IInked 
together. The IInk entry of the last section of 
any chain contains @FFFFFFFF@. 


ADDRESS 
HAHN RS 
03019265 


Figure 12-2. Memory Dump Sample Showing Section Layout 


FTE 
i 38 
0000 
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TRAILING MEMORY DESCRIPTOR FORMAT 


The trailing descriptor consists of three fields. These are as follows: 


S1ZE 


LINK 


ANALYZER LISTING 


The analyzer lists the descriptor fields in a standard manner for all sections. This layout consists of 
one line of titled information comprising the flag field, the preceding descriptor information, the trail- 


SIZE: 2 bytes 
LINK: 4 bytes 
FTE (VALIDATION): 2 bytes 


This entry contains the size of the next section 
of the file table or the particular buffer. If 
the preceding section Is the last section of the 
file table or the buffer, this entry contalns 
@FFFF@. 


For buffer sections, the Iink entry in the 
trailing memory descriptor is used to address 
the first byte of the next section of that 
particular buffer. The link entry of the last 
section for that particular buffer contains 
@FFFFFFFF@. 


For file table sections, this entry points to 
the preceding descriptor of the file table 
extension section associated with the file 
table. If no file table extenston section exists 
for this file table, this entry contains 
@FFFFFFFF@. 


For file table extension sections, this entry 
addresses the preceding descriptor of the next 
file table extension section for the file table. 
This entry in the last file table extension 
section for the file table contalns @FFFFFFFF@. 


For all other section types, this = entry 
addresses the preceding descriptor of the next 


section of the same type. The last section of a 


particular type contains @FFFFFFFF@. 


ing descriptor information, the address of the section, and the validation field. 


FILE TABLE STRUCTURE 


File table information is kept in two structures, the file table and the file table extension. 


A file table entry is built when a CMS data file is first opened and it is maintained until a close reduces 
the user count to zero. Each file table entry (FTE) has one or more file table extensions linked to it. 
Each extension has four entries (FTEE). Each entry is a buffer descriptor that points to and controls 


a data buffer. 
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The exact layouts are described in the following subsections. 


FILE TABLE ENTRY 


A file table entry section contains the following information: 


DA FILE TAG 


COMMON EOF 


TOTAL_DESC 


NUM USERS 


SHARED RECORD SIZE 


SHARED BLOCK SIZE 


AREA | NFORMAT ION 


This 4-byte fleld Is an tnternal Identifier for 
the file. 


This 3-byte fleld holds the shared EOF for al! 
userse 


This i-byte field holds the number of 
descriptors allocated. 


The number of users of this file. 


ite) 


This 2-byte field holds the common record size 
for shared file users. 


This 2=byte fleld holds the common block size 
for shared file users. 


There are 16 entries, one for each possible area 
(disk only). Each entry Includes the fol lowIng: 


UNIT 1 byte The DA CT Index of the device 
ADDRESS 3 bytes Disk address 
S1ZE 3 bytes Number of blocks In thls area 


FILLER 


55 bytes reserved for future use. 


FILE TABLE EXTENSION ENTRY 


Each file table extension contains up to four buffer descriptors. The FTEE includes: 


Map 


Buffer Descriptors 


These four 1I-byte fields contain the task IDs of 
the owners of these descriptors. If a 
descriptor Is unassigned, the corresponding byte 
will be @FF@. The first byte refers to the 
first descriptor, etc. 


These are 40 bytes each, and are described in 
detall In the next subsectlon. 


A sample from an actual memory dump is shown in figure 12-3. 


BUFFER DESCRIPTOR FORMAT 


Each buffer descriptor is laid out and analyzed as follows: 
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Deser I ptor 


Block ID 


FIB ID 


Lock 


Flags 


Untt No 
Queue Status 
Action 1D 
Return Status 


Forward Link, 
Backward Link 


Opcode 


Buffer Address 


Size Parameter 


This number Is developed by the analyzer- 


This 3byte field contains the block number In 
the file of the Information In this buffer. 


The first byte Is the FIB ID, the second the 
owner « 


Contains the ID of the owner of the block when 
It Is locked. If It Is @FFFF@, the block Is not 
locked. 


These define the state of the buffer as follows: 


Buffer allocated 
Move outstanding 
Shared buffer 
Buffered ahead 
Waiting 

Updated 

Printer backup 
Record outstandI ng 


Prey ee eS eT) 


Unit number for this 1/0 (index Into DA_CT). 
Status of descriptor in queue (see PHT section). 
Action ID of requestor If walting. 

The 1/0 status (see PHT section). 

Links for queueIng. These are I/0 descriptors. 
They are two-way links for possible future use. 
Presently, everything is linked In the forward 
direction. 

Operation requested. (See PHT section for 
normal operations, and Command Table section for 


speclalized disk operations). 


Address of first section of buffer: 


Size 2 bytes 
Bus & page 2 bytes 
Address 2 bytes 


Total size of buffer In bytes. 


Device Dependent Parameters 


Device-dependent parameters, 9 bytes. 


Note that the address In 1/0.DESC = @FFFF@ If no buffer exists. 


PT VT ETSI IT rieritittrerirers tery PRECEEDING TRAILING 
FELE TABLE. EXTENSION ENTRY CFIEED FLAGS SIZE LINK SIZE LINK AUDRESS MAP FTE FTEE 
RARLSRRKAHKRSRKRAHRAA ARERR KRARAANHHE anna iO REREERRAER RHARERH ann wen anne 
02 B4G0 FFFFFFFE 8400 FFFFFFFF 045015566 000010FF Go00 0000 
DESCRIPTOR G1 
BLOCK 4D 8000 00 
FIB 10 1205 
LOCK FEFF 
FLABs. 80 
UNIT NUMBER 04 
QUEVE STATUS U3 COMPLETE AND OEQUEVED 
ACTION 10) OF 
RETURN STATUS 0190 uO COMMAND COMPLETE sO ERROR 
FORWARD LINK 0301 5377 
SACKWARD LINK QUOi CAMA 
Op CODE au READ 
SUFFER ADDRESS g400 u30k 1F67 
SIZE PARAMETEK 68400 
DEVICE DEPENDENT PARAMETERS uvuiD 3302 0004 0009 vO 
ALLOCATED UNCONDITIONAL I/D NOT SHARED NOT BUFFERED AHEAD: 
NOT iM USdSée NOT UPDATED NOT PRINT BACKUP NOT OUTSTANDING 
PRECEEDING TRAILING 
FLAGS Si/F LINK ST7E it TwK aDNRESS 
annnn ata ante han aneae eetntan 
10 8409 F=FEFFFE 8400 FFFFFFFF 03611F67 
DATA OPZE 3445 6934 FoAP FANC 414E 4755. 4447 4520 5459 5045 2048 41453 2054 SFAF 2040 
414E 5920 434a 4152 41443 5445 5253. 404E 4420 FFCO FFAu 2056 4552 4220 §54E 5952 
4945 5323 5550 4441 5445 4454 4849 5520 4954 4540 2043 414E NEGF 5420 9245 2054 
S244 4E5o 4C41 5445 4440 4955 2040 4154 4348 2046 4F55 4E4N 2049 4E20 4ERS 5720 
39445 5354 5245 4S4F 5645 59259 2043 4F4D 5049C 4554 48544 FFCO 2057 4F52 8820 4649 
4C45 cO4O 4YFUA 4445 4453 5420 FFCO 494E 5520 2000 
Figure 12-3. Sample File Table Extension Eatry 
KEY FILE TABLE FORMAT 
KF | LETAG 4 bytes Unique Identifier for file 
NUM_USERS 1 byte f of users with keyflle open 
MAX_KEYFILE SIZE 3 bytes Write EOF 
KEY SiZE 1 byte Actual size of key 
KEY ENTRY SIZE 1 byte Key size reserved (5,13,21,2) 
AREA_|NFO Array [16] of record 
Address 3 bytes 
Length 2 bytes 
INDX_REG EXISTS 1 byte Set If Index region exists 
OVRFLW REG EXISTS 1 byte Set If overflow region exists 
RUF_TBLE 10 bytes See KEYFILE REG FRMT below 
INDX_REG 10 bytes See KEYFILE REG FRMT below 
OVRFLW_REG 10 bytes See KEYFILE REG FRMT below 
HIGHEST RECORD Read EOF 
Area 1 byte 
Sector 3 bytes 
Of fset 1 byte (offset In the sector) 
Key Array [28] of byte 
(last key value end) 
SPARE 25 bytes 
KEYFILE REG FRMT Record 
Starting 
Sector 3 bytes 
Size 3 bytes Number of sectors In starting area 
Starting Area 1 byte 
Distance to 
End Area 3 bytes Starting sector In starting area 
1118478 12-9 


KEY FILE EXTENSION FORMAT 


Key file 
User 
Updated 
Lock 
End List 
List Walting Lock 
Action ID 


Take Lock 


Spare 


SYSIO DESCRIPTOR TABLE 


Not Maintained in 3.04 releases. 


AVAILABLE TABLE 


Lists available buffer space. 


12-10 


Array {71 of record 


2 bytes FIB 1D and TID 

1 byte Flag for this user 

1 byte TID of next user (begin of Iist) 

1 byte Next avallable slot In lock list 
Array [7] of record 

1 byte 

1 byte 

143 bytes 

FORMAT 


BANKS C AND D 


APPENDIX A 


OS ERROR INDICATORS 


The display on these control panel banks is an indication of processor business (normally a communi- 


cate count). 


CLEARSTARTS 


When the operating system encounters an error condition, it performs an error-handling routine which 
terminates with a clearstart. This causes a 3-byte field to be displayed on the hex display and on the 
ODT if its data path is still runable. The three bytes displayed are: 


BANK E -Error number as described below. 


BANK F -Index into the AM.ACTION.LIST for the action in error. 


BANK G -Id of the action in error. 
BANK E -CLEARSTART NUMBERS 
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@00e 


e016 


402@ 


4034 


6048 


405@ 


e066 


a07@ 


606 @ 


DEADLOCK ERROR ~ An action Is attempting to get on a 
queue behind Its parent which Is waiting for It to 
finish. 


NO NUMBERS ERROR - A normal action was Invoked when 
there were already one hundred normal actions In the 
mix, and Activity Management could not assign [t a 
unfque 1D; only 100 ACTION numbers are aval lable. 


BAD ACTION ID ERROR - A _ non-extsting action was 
Invoked. 


BAD SEG ID ERROR - An attempt to access a non-existing 
segment (work block, link block, data block, or code 
block) occurred. 


TOO MANY WB ERROR - An action tried to get a work block 
when It already had four. 


CALL FROM FS ERROR - An action called an Activity 
Management routine from force state which Is not 
al towed In force state. 


CALL BY CONT ERROR - A continuous action called an 
Activity Management routine which fs not allowed for 
continuous actions. 


CALL NOT NORM ERROR - An action attempted to get on a 
queue when I+ was already on a queue. 


WB AT FINISH ERROR - An action attempted to finish when 
Tt stIll owned a work block. 


ene 


G0AG 


eoBe 


a0ce 


4ode 


@0Ee 


@0OFe 


6116 


6128 


6138 


14e 


e15e 


@16¢@ 


ei7@ 


418 @ 


BAD POST ERROR - An action called "POST-RESULT" passing 
an action {D of a non-existing action, or of one which 
Is not awalting a post. 


BAD DEQUEVE ERROR - An action attempted to dequeue from 


a 
a queue where It was not present. 


BAD STOP INT ERROR - An action called "STOP-INTERRUPTS" 
when It was not proccessing Interrupts (not In force 
state). 


BAD AWAIT INT ERROR - An action called “AWAIT- 
INTERRUPT," specifying a channel which was being 
serviced already by some other actlon. 


ZERO DIVIDE ERROR - An action called "ABS.DIVIDE” 
passing a zero divisor. 


PARITY ERROR - A parity error was detected by the OS 
processor. The State Save of a 2-MHz machine will have 
the address of the offending memory location IIsted 
under "IC - First Error Register" In the dump. 


BAD CLEAR ERROR - Software sent micro execution to 
address zero on any page. 


PREV MARKED ERROR - An attempt was made to mark a work 
or Ifnk block with the state which It was already in 
(Jelled, frozen, unJelled, or unfrozen). 


MARK COUNT ERROR - An attempt was made to freeze or 
jell a code or data block which already had 15 
outstanding freezes or Jells against It. 


MEM CORRUPT ERROR - A virtual memory descriptor has 
been corrupted. 


BAD CHANNEL ERROR - A call to "AWAIT-INTERRUPT" or 
"STOP-INTERRUPTS" was made which specified an [Illegal 
channel number. 


STK OVERFLOW ERROR - An action called Activity 
Management with Its stack pointer pointing beyond Its 
allocated space. 


CONT VM ERROR - A continuous action required virtual 
memory for any reason. 


BAD ENQUEUE ERROR ~ An action attempted to enqueue to a 
non-existing queue.» 


CB FREEZE ERROR - An attempt was made to freeze a Code 
Block. 


VM REQUEST ERROR ~ The function which virtual memory 
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4196 


@1Ae 


a1Be 


é1ce 


@104 


e1ce 


@iFe 


6208 


was requested to perform does not exist. 


VM LOCATE ERROR - The Work Block or Link Block which 
virtual memory was requested to load In memory does not 
exist. 


VM 10 ERROR - An 1/0 error was reported In an attempt 
to read/write to the MCP file. 


The exact error and the sector in error can be found as 
follows: 


Determine the action running In the os 
(AM-ACTION.-LIST). The action should be AM_VM. The comm 
fletd can be decoded as follows: 


Orive number Byte 1 

MTR status Bytes 2-3 
Sector address Bytes 4-6 
Unused Bytes 7-9 
Retries Byte 10 


Orive number is as In disk processor, where O Is A, 1 
Is B, -osee, 7 IS He MIR status Is defined In the Disk 
Management section of this manual (section 11). 


The same Information exists In the disk processor 
memory» If necessary, it can be decoded. 


The normal recovery action Is to utilize a different 
system disk to warmstart from, then take appropriate 
action with the falling disk, depending on the nature 
of the fallure. FE assistance may be required. 


NO AVAIL MEM ERROR - Sufficient avallable memory cannot 
be obtained to satisfy the virtual memory request due 
to the number of Jelled or frozen memory blocks. 


COMPACT VMFIL ERROR - Virtual memory was unable to 
relocate a work or IInk block within the Backing Store 
portion of the MCP file. 


OS VMFIL FULL ERROR - The Backing Store portion of the 
MCP file Is completely fllled. 


COMPACT MEM ERROR ~ Virtual memory was unable to create 
a block of contiguous available space of sufficlent 
size to satisfy the request, due to the presence of 
frozen memory blocks. 


BAD BLK TYPE ERROR - An unrecognizable block type was 
encountered by virtual memory in the process of 
compacting memory. 


WARMSTART ERROR - An error encountered by the Data 


e216 


4€22@ 


42354 


a24e@ 


@256@ 


6268 


e276 


aBa 


a2e 


@2A@ 


@2B6 


@2Ce 


@208 


Access activity of the operating system during the 
startup process. 


SYSCONE IG ERROR - An error was encountered while trying 
to access the SYSCONFIG file. An open or read error 
results In this error. 


POWER OFF ERROR - A call to SYSTEM ERROR was made to 
stop the system because a Power Off command was 
recelved rather than because of an error. No error 
display Is made. 


ATTACH BLOCK ERROR - An action attempted to attach a 
non-existent structure, attach a structure with one 
already attached, or locate a data block with one 
already attached. 


DETACH BLOCK ERROR - An action attempted to detach a 
structure that was not attached. 


INTRANSIT ERROR - Virtual memory cannot locate a 
section of memory I+ Just allocated. 


MEMORY LIMIT ERROR - The hardware detected that the 
processor attempted to address a memory (RAM or ROM) 
that Is not In the system; often Indicates a disk drive 
and/or media problem. 


BOUNDARY ERROR - The hardware detected that the 
processor tried to access the IC memory map when It did 
not Intend to, or that the processor tried to Increment 
through address @FFFF@ on any page 


FILE TYPE ERROR - This error Is generated when the Data 
Access activity, SYS OPEN, Is requested to open a file 
that Is not a system file. 


NO SIZE VMFL ERROR - This error Is generated when an 
attempt Is made to open a VM file which has a file size 
of zero. 


VMFL 1S OPEN ERROR - This error Is generated when an 
attempt Is made to open a VM file which is already 
open. 


SYSFL OPEN ERROR - This error ts generated when an 
attempt Is made to open a system file which has a_ file 
type other than SYSTEM, LOG, CODE, or INTERPRETER, 
which Is already open. 


NAMTAB OVER ERROR - This error Is generated when an 
attempt is made to open a system file with the maximum 


number of files already opened for that file type. 


Reserved. 
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@2E@ 


@2F@ 


@30@ 


esié 


@324 


@33@ 


@54@ 


6356 


6368 


6576 


eB @ 


ape 


A3Ae@ 


@35Be 


a3Cce 


@50e 


ILLEGAL WRITE ERROR - This error Is generated when an 
attempt is made to perform a SYS-10 write to a file 
that Is not opened with a usage of read/write. 


INVALID OP ERROR - This error ts generated when an 
attempt Is made to perform a SYS-!0 operation with an 
opcode other than read, write, or search. 


Reserved. 


CLOSE ADV ERROR - This error is generated when a SYS- 
CLOSE with purge of a file with type other than 
miscellaneous, list, NDLSYS, or VM-FILE Is attempted. 


NOT VMFILE ERROR - This error Is generated when an 
attempt Is made to add an area to a system file other 
than a VM file, or to dump to a file other than a YM 
file. 


ADD ZERO SIZE ERROR - This error Is generated when an 
attempt Is made to add an area of size zero to a VM 
file. 


QUEUE MAINT ERROR - This error is generated If an 
Illegal descriptor was sent to a physical 1/0 module, 
or If an invalid unit number was detected. 


10 DESC ERROR - This error Is generated If the 1/0 
handler sent an {fl lega! descriptor. 


Reserved. 


DA PHT OVER ERROR - This error is generated when there 
are more than 20 devices on the system. 


KEYFILE FRMT ERROR ~ An error was encountered tn 
accessing the keyfile (of an Index pair) that could 
onty occur as a result of the keyfile being formatted 
Incorrectly. 


DA OUTCOME ERROR - This error Is generated when an 
unrecognized output from the 1/0 subsystem Is recel ved. 


DA BUFF MEM ERROR - This error Is generated when an 
Internal data access error Is detected during a buffer 
memory operation. 


DA SCL ERROR - This error is generated when an 
unrecognized output from a utility or the 1/0 subsystem 
procedure Is recelved. 


Reser ved 


Reserved. 


@5E6 


a3F@ 


a40e 


441@ 


6428 


e438 


a44e 


4456 


0466 


a476@ 


6486 


e496 


e4Ae 


e40e 


e4Ee 


e4Fé 


4508 


a51e@ 


START O| ERROR - A problem has occurred [n "START-O1" 
(operator Interface); probably a bad outcome In trying 
to access a system file  (SYSMCP, SYSOONFIG, 
SYSLANGUAGE ). 


Reserved. 
Reserved. 
Reserrved. 
Reser ved. 
Reserved. 
Reserved. 
Reserved. 


JM START OPEN ERROR - An Interpreter file open has 
falled. 


JM START TP ERROR - The load of an Interpreter to a 
task processor has falled. 


JM START READ ERROR - A read from an Interpreter file 
has falled. 


JM OPEN PROG ERROR - Open of a program file has 
resulted In the return of an unexpected fallure value. 


JM OPEN INTRP ERROR = Open of an interpreter file has 
resulted In an unexpected outcome value for fallure. 


JM OPEN VM ERROR - Open of a VM file has resulted in an 
unexpected fallure value belng returned. 


JM TP ERROR - The task ID or mix number given by the 
Invoker of the task procesor error action Is Illegal, 
or a request made of a task processor has been rejected 
by [t- 


JM ACCESS ERROR - Information passed to the MIX-ACCESS 
action Is Invalid (fn all cases, the task Id)- 


JM MX NAME ERROR - Information used to get a task name 
from DA (through DA.NAME-FIBID) gave a bad result. 
Error could be In JM or DA software. 


Reser ved. 


JM ST ERROR - This error Is detected by the STOP action 
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4528 


6538 


e548 


6558 


656¢@ 


a57@ 


abe 


4598 


@5A@ 


e55e 


6656 


6668 


a6ce@ 


@6ré@ 


Indicating that a specified job is In an Invalid state. 


JM SUPER ERROR - A_ startup time detected error 
Indicating that the Initial load of SYSSUPERUTIL was 
unsuccessful» 


JM DSDPFLAGS ERROR - A Job belIng DS-ed or DP-ed has the 
state flags In disarray. 


JM EQJ ERROR - The end of Job code has been entered for 
a Job whose state flags make no sense. 


JM TERMFLAG ERROR - The terminate flag was set with no 
terminate condition existing. 


Reserved. 


JM DCJOBREM ERROR - The DC Job removed action has been 
called for a job whose flags say it Is not terminating. 


JM JOBRUN ERROR - A TP has notified the OS that a newly 
loaded Job [s running when no such notification was 
expected. 


Reser ved+ 


JM SELECT ERROR - The processor selected for the load 
of a Job has falled for unexpected reasons. 


JM TASK ID ERROR = A task processor sent a task ID to 
the OS that does not exist. 


JM SYSCONFIG !0 ERROR = An !0 error occurred while JM 
was accessing the SYSCONFIG fille during warmstart. 


Reserved. 
Reserved. 


DC RWL ERROR = The DCA (Data Comm Activity) attempted 
to access one of the queues, but was stopped because 
the READ-WITH=-LOCK flag was set. 


DC IOI Error - The result function has found an Invalid 
message type on the system result queue. This problem 
could be caused by running with an Incompatible version 
of MCP= and NPC-generated code files. 


Reserved. 


P| PROCESSOR ERROR - An attempt was made to send a 
message to an illegal bus address ( X15, for example). 


Pl TP TASK 1D ERROR - The TP was asked to do something 
for a task that fs not running on that TP. 


A-8 


a70@ 


aia 


4724 


a78@ 


4794 


6968 


@76@ 


498 @ 


aoe 


a9Ae 


@Ba 


@ce 


GF 0e@ 


@F1@ 


MOVE RESULT ERROR - An unidentified result was returned 
from P| MOVE by the TP. 


Reserved. 
Reser ved. 
Reserved. 
Reser ved. 


BAD DFH LOCK ERR - OPEN or CLOSE attempted to read a 
disk file header without having acquired the disk file 
header tock. 


ZERO ALLOC ERR - The system attempted to allocate a 0- 
sized area on disk. 


BAD ALLOC ERR - The system attempted to allocate an 
area with an area number greater than 16. 


BAD INDEX ERR - The system attempted to access a disk 
file header with a directory Index greater than 2805. 


Reserved. 


BAD DFH ERR ~- The system attempted to write a disk file 
header with an Improper value In the FLAGS or EOF 
field. 


BAD PACK TAG ERR - A PPIT search operation returned an 
Invalld pack tag to the system. 


Reserved. 


DISK PROC ERROR - The disk processor detected an error. 
To determine the reason for the error, a ROM dump must 
be taken and analyzed. The Save Area of the dumo 
contains the IC Status which will Indicate the type of 
error. Figure 8-1 of this manual should be helpful. 


SUZIP FAIL ERR - On an unattended system, the program 
to be zipped at system startup time encountered a Load 
fallure. The following two bytes of the display give 
the FCM value for the zip fallure. 
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APPENDIX B 


TASK PROCESSOR SAVE ERRORS 


The task processor error numbers defined below are reported as the ‘‘Error Number’’ in a processor 
entry of the error log or in the dump’s State Save Area for a task processor. 


a00e 


aote 


4026 


403e 


a04e 


e05e 


8068 


a07@ 


lest) 


ene 


a108@ 


aiié 


4128 


e134 


Hardware detected error. 


FS YIELD PROC - Force state has been detected while 
entering PM function YIELD PROCESSOR. This’ function 
should not gain control while in force state. 


ILL CALL AP = Two actions are allowed to call PM 
function ASSIGN PRIORITY; these are JC INTERP ACTION 
and JC COMMAND HANDLER. These errors [Indicate the 
caller was neither. 


FS ASG PRIOR - Force state has been detected while 
entering PM function ASSIGN PRIORITY. This function 
can not gain control while In force state. 


FS INVOKE - Force state has been detected while 
entering PM function INVOKE. This function can not 
gatn control while In force state. 


FS FINISH - Force state has been detected while 
entering PM function FINISHED. This function can not 
gain control while In force state. 

FLRISH ON 6 =-PM FINISHED: has besa invoked «te “takeo a 
status block (SB) off the linked lists; but the SB can 
not be located. Assume that the SB is still on a queue 
which Is In error. 


Reser ved 
Reserved 


ENQ ILL Q - An fnvalid queue name has been passed to PM 
function ENQUEUE. 


Reserved 


DEQ ILL Q - An Invalid queue name has been passed to PM 
function DEQUEUE. 


ILL POST - A PM POST has been Invoked on a SB that does 
not have a status of WAITING POST. 


DEQ NOT HEAD - A SB has Invoked DEQUEUE to get off a 
queue while it Ts not at the head of the queue. 


B-1 


a14@ 


e15e 


@16@ 


ei7e 


aise 


e198 


@ic@ 


e208 


4216 


4228 


@256 


@24@ 


6258 


@268 


@27@ 


FS PRE POST - Force state has been detected while 
entering PM function PRE POST CALLER. This’ function 
cannot galn contro! while In force state. 


FS MEMSPACE - Force state has been detected while 
entering PM functlon MEM SPACE. This function cannot 
gain control while in force state. 


FS MARK - Force state has been detected while entering 
PM function MARK. This function cannot gain control 
while In force state. 


MEM SP NO WB - A JC or PI action has called MEM SPACE 
to allocate a WB when the maximum IIimit of four has 
already been allocated. 


FS FREE SPACE - Force state has been detected while 
entering PM function FREE SPACE. This function cannot 
galn control while In force state. 


ILL FREE SPACE - A SB has called FREE SPACE to 
deai locate a structure, and FIND WB was unsuccessful In 
locating the structure. 


TASK LIMIT EXCEEDED - More than the legal amount of 
tasks allowed In the mix have been Invoked. 


FS LINK WB - Force state has been detected while 
entering PM function LINK WB. This function cannot 
gain control while In force state. 


ILL INVOKE - An action has been called by INVOKE, but 
the action name does not exist (Is out of bounds). 


MARK CODE SEG - MARK has been called to modify a 
structure of type SCODE. Only WM Is authorized to do 
this. 


INVOKE VM ~ VM has been called by INVOKE; VM cannot be 
Invoked. 


INV TOO MANY ACT - An action being Invoked [s_ non- 
critical; yet, due to lack of space In the SB ADDR 
ARRAY, It has overflowed Into the area reserved for 
critical actions. 


AP NOT ON LIST - A search of the IIst heads by the 
action ASSIGN PRIORITY was unsuccessful In locating the 
SB of the task. 


DEALLOC TYPE - Work block being deal located was nel ther 
type Normal, SB, !CB, TCB, or PCB. Invalid use of 
DEALLOCATE. 


ILL TRANSFER WB ~- TRANSFER WB was called to give up 
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a2 a 


ane 


e306 


a31@ 


z9 
Se 


@336 


4348 


@35@ 


@36@ 


65764 


aBe 


axe 


a3ce 


a3De@ 


asc@ 


ownership of a WB,but was not successful in locating 
It. 


ILL LINK WB ~ LINK WB was called to delink a WB = and 
relink I+, but WB was not found. 


Reserved 


WB NOT FOUND - FIND WB has not found a specified WB, 
and the error flag was one In some cases, not finding 
a WB Is not an error, but It is In this case. 


FS LOCATE SSEG - Force state has been detected while 
entering PM function LOCATE SSEG. This function cannot 
gain control while In force state. 


ILLEGAL JOB COMMAND - The GS processor has requested 
the TP to perform an tnvalid job command. 


ILLEGAL IN REQ ~ The 0S requested an invalid function 
of the task processor. 


INTERPRETER NOT LOADED - The OS requested the task 
processor to run a task for which there [Is no 
interpreter. 


ILL MARK REQ - MARK has been called In order to mark a 
WB, but FIND WB was not able to locate the WB. 


FS GET SEGS - Force state has been detected while 
entering PM function GET SEGS. This function cannot 
gain control while In force state. 


WS FATAL - No entry In the warmstart table (planted at 
startup time) has been found for this task processor 
during START PM. 


INV ILL INT TASK = An Interpreter action has been 
detected having an illegal action ID. This means the 
ID Is not In the range of SB ADDR SLOTS set aslde for 
INTERP ACTIONS. (INVOKE) 


MARK DATA SEG - MARK has been called to modify an s- 
data type structure. Only VM Is authorized to do this. 


GET SEGS MANY - An [Interpreter requested an Invalid 
number of segments (0 or more than 3) or requested more 
than one code segment. 


GET SEGS KIND - The Interpreter requested an invalid 
type of segment (not a data or a code segment). 


INVALID INTERPRETER NEED - The Interpreter requested an 
Invalid NEED. Valid NEEDs are: Communicate, Get 
Segment, Yield, Program Error, or System Message. 


B-4 


e40@ 


e416 


@42@ 


4466 


64768 


4508 


a51@ 


4528 


6538 


4548 


@558@ 


e57@ 


e584 


a50e 


a60@e 


a61@ 


Reserved 


CLEAR START ERR - Indicates that START PM has been 
entered for a second time. START PM Js not reentrant. 
(HARD ERROR) 


Reser ved 


SOFTWARE ERROR - Task processor execution led to an 
Ihlegal software operation. 


HARDWARE ERROR ~ The TP went logically Not Ready due to 
a hardware-detected error: Parity Error, Memory Limit 
Error (the TP attempted to address a nonexistent 
memory), Boundary Error (the TP tried to Increment 
addressing through the end of a memory page: GFFFF@). 


WS PAGE 0 SIZE - The size of page 0 Is too small to 
support the execution of the ICP. 


WS END OF TABLE - the Warmstart Table !oaded by the OS 
Is corrupted. 


VM TID ERROR - FIND WB was unable to find the TCB of 
the task. (VM ACT CODE of WM) 


YM ERROR = Descriptors exist for data and 

code segments in a TCB, PCB, or ICB; If the type passed 
Is nelther of these, error ts noted. (FIND SSEG DESC 
of VM) 


DISK 10 ERROR - FIND SSEG DESC was unsuccessful [In 
locating the segment descriptor. (DO DISK 10 of VM) 


GETSEGSP ERROR - FIND SSEG DESC was unsuccessful In 
attempting to relocate the seg table. (GET SEG SPACE) 
SETUP DISK ERROR - The number of segments reque 
be brought In was greater than the maximum of 3. (SET 
UP DISK of WM). 


s 
s 


SETUP2.DSK.ERROR - In procedure SET-UP.DISK, which Is 
bull ding a SYSIO COMM to bring In segs, the FIND SSEG 
DESC rountIine was unsuccessful. (SET UP DISK of WM) 


CHECK VIC ERROR - YM victim segment has no associated 
descriptor; FIND SSEG DESC failed. 


VM HO ROOM ~ VM was Invoked for other than LOCATESEGS. 
(CHECK NO ROOM). Segments can not fit In memory. 


NO MEMORY - MAKE SPACE has been unsuccessful. (VM ACT 
CODE) 


VICTIM SEG ABS - A segment chosen as a victim by W has 
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@62@ 


@634 


8648 


e658 


e668 


467@ 


@67@ 


868 @ 


e69e 


aoe 


ale 


an associated descriptor which shows the segment 
absent. (CODE DATA VICTIM) 


DO COMP ILL TYPE - During the actual compacting part of 
WM, the next block of memory has been found to have an 
Itlegal type. (DO COMPACTING) 


SEG COMP NO WB - In DO COMPACTING, SEG COMPACT has been 
called, which called FIND SSEG DESC, and falled to find 
the descriptor table. (SEG COMPACT) 


GETSPACE TYPE ERR - A segment type Is out of range, 
meaning It Is neither VM FILE, PROG FILE, INT TYPE, 
ZERO, or GARBAGE FILL. (GET SEG SPACE In VM) 


Reserved 


VM GETSEGS NOTCB ~ VM has cal led FIND SSEG DESC to find 
the ICB/TCB/PCB for a segment, and It was unsuccessful. 
(VM GET SEGS In VM) 


Reserved 
Reserved 
SRCH UPSEGS ADOR - The last pass of the virtual memory 
atgorithm has searched through memory, and was not 


successful In locating space. 


SRCHUPSEG NOTCB - FIND SSEG DESC has failed. (SEARCH 
UPDATED SEGS) 


JC INTERP COMM - TCB flags are zero. (JC  INTERP 
ACTION) 


JC ILL OP CODE - Command handier action has detected 
that a command Is out of range. Bad parameter. 


APPENDIX C 
SYSANALYZER ERROR MESSAGES 


An error detected in the dump file by the SYSANALYZER, or an error in the analysis, causes an error 
message to be generated within the analysis printout. These error messages are identified by one string 
of three dollar signs before the message, and another after the message: ‘‘$$$ ERROR MESSAGE 
$$$.’? Messages without three dollar signs are merely warnings. 


$$$ NO xx ID.TABLE ENTRY $$$ 


No ID.TABLE entry (as documented in the dump file map) was found for the memory type requested. 
The memory types (‘‘xx’’) are defined as follows: 


OS -Operating System 

TP -Task Processor 

DC -Data Comm Processor 
DK -Disk Processor 


BM -Buffer Memory 
$$$ CIRCULAR LIST ERROR $$$ 
A list that circled back on itself did not circle back to the beginning. 


$$$ REVERSE LINK ERROR $$$ 


In a list that has forward and reverse links, a forward link was followed from entry <a> to entry 
<b>, but the reverse link in entry <b> did not point to <a>. 


$$$ QUEUE TAIL ERROR $$$ 


While analyzing a queue having a head and a tail, the tail was found not to be pointing at the last 
entry reached via the forward links. 


$$$ TABLE SIZE NOT MODULO 8 $$$ 


If this message occurs during the TCB analysis, it means that the difference between the stack base 
and the DST base in a certain TCB is not modulo 8. 


If this message occurs during the ICB/PCB analysis, it means that the difference between the Code 
Segment Table (CST) limit and the CST base in a certain PCB is not modulo 8. 


$$$ QUEUE LINK GREATER THAN QUEUE SIZE $$$ 

The queue link points beyond the end of the table of status blocks through which the queue is linked. 
$$$ STE LENGTH NOT EQUAL SD SIZE $$$ 

The segment table entry iengih is not equai to the segment descriptor size. 


$$$ SD OWNER NOT EQUAL PD/BD OWNER $$$ 


The segment descriptor owner is not equal to the physical descriptor/block descriptor owner. 
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$$$ SD WB.ID NOT EQUAL PD/BD WB.ID $$$ 


The segment descriptor work block ID is not equal to the physical descriptor/block descriptor work 
block ID. 


$$$ SD SEGMENT NUMBER INCORRECT $$$ 

The segment table entry number does not equal the segment number. 
$$$ LIST INDEX GREATER THAN LIST SIZE $$$ 
List index is greater than the list size. 


$$$ DYNAMIC ARRAY DECLARATION ERROR $$$ 


An attempt to declare data space dynamically in order to perform an analysis resulted in a value either 
zero or greater than 5000 bytes. The data declaration does not occur, and the specific subsection of 
analysis is skipped. 

$$$ LIST SHOULD NOT BE CIRCULAR $$$ 

A straight list has been detected to circle back on itself. 


$$$ DISK READ ERROR $$$ 


An “ERROR”? status has been returned to SYSANALYZER while it was trying to read from disk. 
Analysis continues at the next logical startup point. 


$$$ SEGMENT TABLE ID MISMATCH $$$ 
The value of a segment-id, as passed to the SYSANALYZER in the dump file’s header record, does 


not match the value built into SYSANALYZER in order to print the names of the various segments 
in the segment table. 


$$$ ADDRESS ERROR $$§ 


When the value of the indicated address is added to the indicated length or offset, the sum exceeds 
the last address for the page of memory involved. (The last address for the page is determined from 
the Dump File Map.) 

$$$ TYPE INCORRECT $$$ 


The least digit of the physical descriptor type is incorrect. For TCB analysis, it should be 7; for PCB 
analysis, 8; and for ICB analysis, 9. 


$$$ P.STATUS /=WAIT.CRIT.INV $$$ 

The status field of the status block does not equal @04@. 
$$$ ID'S DO NOT MATCH $$$ 

The preceding and trailing IDs do not match. 


$$$ SIZES DO NOT MATCH $$$ 


The preceding and trailing sizes do not match. 
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$$$ SIZE LESS THAN 7 $$$ 

The preceding size is less than 7. 

$$$ FORWARD PD ID ERROR $$$ 
The forward physical descriptor ID is not @06@. 
$$$ REVERSE PD ID ERROR $$$ 
The reverse physical descriptor ID is not @06@. 
$$$ FORWARD PD SIZE ERROR $$$ 


If 6 is added to the status block size array entry that is indexed by the action name, the result does 


hueiaanl A tet ain 
trequal the forward. physical deseriptGr. size: 


$$$ REVERSE PD SIZE ERROR $$$ 


If 6 is added to the status block size array entry that is indexed by the action name, the result does 
not equal the reverse physical descriptor size. 
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APPENDIX D 
USER TASK ANALYSIS 


To assist in tying a user job to all of the various control and parameter blocks associated with it, use 
the following outline: 


VIRTUAL MEMORY 


1. From the mix table, locate the desired job and record the following information: 
1) Task ID. 
2) Mix Processor. 


3) Program FIB ID (least significant byte = PCB ID). The PCB ID can be used to locate the 


PCB in the task processor. 


TASK PROCESSOR <PROCESSOR NUMBER> 


1. Scan the TCB.heads for BH.ID = <task ID>. NOTE: scan all memory pages. 
2, Beneath each TCB are the FPBs associated with that task, if any. 


The least significant byte of the ‘‘SD’’ number of each FPB is the associated FIB segment num- 
ber (FIB ID). 


OPERATING SYSTEM 


1. Scan the WB.LB.HEAD for “‘owner” of DA.TASK <task ID>.LIST. 
NOTE: Convert <task id> to decimal. 


Deen €Ts WD c 


‘an the FIB List below the WB.LB.HEAD for: 


bho 
7p) 
Qa 
rN] 


1) ‘‘Owner’’ as determined in step 1 above. 
2) “‘ID’’ (FIB ID) as determined in step 2 for Task Processor number above. 
3) Assemble a DA.FILE-TAG from FIB entries: 

a. File tag info (1 byte). 

b. File tag directory (2 bytes). 


c. File tag packtag (1 byte). 
NOTE: DA.FILETAG = <file tag info> <file tag directory > < file tag packtag>. 


BUFFER MEMORY 
Scan FTE entries for DA.FILETAG as assembled in step 3) above. 


The FTEEs associated with the FTE are immediately following it. 
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NOTE 
Four FTEE descriptors will be listed, and the map of the FTE will indicate 
the number of them that are active. The associated 180-byte buffer sections 
and their contents will follow each descriptor. The buffer sections are linked 
together by the ‘‘trailing link,’ which points to the address of the next buffer 
section. The last buffer section of an FTEE will be linked to @FFFF 
FFFF@. The FTEE itself will have a trailing link of Fs unless there is more 
than one FTEE associated with an FTE. 


APPENDIX E 
A GUIDE FOR TROUBLESHOOTING SYSTEM FAILURES 


INTRODUCTION 


Some initial steps should be taken in any trouble-shooting effort. It is not always possible to do all 
of the things suggested but the more of these suggestions that are followed the easier the task of trou- 
ble-shooting will be. 


1. Record all information which appeared on the ODT and on the lighted displays when the error 
occurred. 


2. Get a dump. 
If the system clearstarted and created a dump file in the process, this will be indicated by messages 


which appear on the ODT. If no messages have appeared and the system will still respond, take 


: 
acdunnp using the Gol MD -commanan thavOor isaict communicaine a. RO cule Suoule be 


taken. 
Once the dump exists it is ready to be converted into a readable format. 


If the dump is a system dump (created automatically or by GT MD), it can be converted using the 
SYSANALYZER program. 


If the dump is taken using the Hex keypad (a ROM dump), it should have ROMCONVERT run 
against it. The output of this procedure is then used as input for the SYSANALYZER program. 


There are times when ROMCONVERT can not be run. In this case, run ROMANALYZER against 
the ROM dump. 


(Directions for all these procedures are contained in the System Operations Guide.) 


3. Acquire the log file of the activities on the system when the problem occurred (use the PL com- 


sdsCasa ye 


4. Make a copy of the SYSCONFIG file. 


5. Talk with the personnel at the site and make a note of any unusual activity when the failure oc- 
curred. 


6. If a clearstart occurred and the error message is available (the number in Bank E of the Hex 
display), the meaning of the message should be established using Appendix A to decode the num- 
ber. 


SUGGESTIONS/HINTS 


The suggestions which follow have been accumulated from successful field engineers and are included 
here in the hope that they may be of help to others. 


IF THE SYSTEM CAN’T BE RE-WARMSTARTED 


Try the redundancy switch(es), OS and/or DISK, to confirm that the problem is in the suspected 
primary processor. 


Coldstarting is a good test of the hardware. It is a good idea to: 
Replace the system files (RP). 
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If it will not damage the customer’s operation too much, re-initialize the fixed. disk, and then load 
the system files from the B9OORLI disk using the LD command. 


PERSISTENT PROBI FEN 


iw ELINI 1 a 


Run the appropriate MTRs. Be sure to check the MTR configuration against the configuration 
shown when CONFIGURER is run. 


A LARGE NUMBER OF CHIPS SEEM TO BE FAILING 

The problem may be a wire to that card/circuit or a track on that card. 
ENVIRONMENT IS IMPORTANT 

If the room is too hot the disk platters may expand and the disk can not be read properly. 
If the air is too dry, static may be causing problems and static mats may be needed. 


Review the log files for the date and time of failures. It may turn out that the customer is working 
after hours or on weekends when in-house air conditioning is switched off. 


CHECK CONNECTIONS 


Check the power supply. Hot or discolored fuses indicate that the connection is bad. This can cause 
low line voltages which can, in turn, affect the system memory. 


All 1/O cables and I/O cable plugs should be checked to be surc that they are firmly seated. 


The examples which follow are intended to be helpful for problems on different system configurations. 
It should not be assumed that all types of problems have been addressed. 


In following the outlines for the different system configurations, follow the instructions only to 
the point where a reason for the failure is found. 


SYSTEM CONFIGURATION 1 
System aborts with a SPO and a printer 
CONDITION 1: CLEARSTART - DUMP CREATED 
1. Analyze clear start message. 
2. WIE! system WARMSTART? 
1) Sf no: 
a. Analyze WARMSTART fallure code. 
be Replace system files, and rewarmstart. 
ce Run MTRs- 
2) If yes: 
a. Print and analyze log files. 


bs Print and analyze KA and LR of all disks on IIne at time 
of CLEAR/START. 


3) 


Ce 
de 
ee 


Run MTR. 
Print dump file. 
Analyze appropriate areas for hardware errors. 


If reason for CLEAR/START Is not found In steps aor b, 
submit FTR. 


CONDITION 2: CLEARSTART - DUMP NOT CREATED 


CONDITION 3: SYSTEM HUNG - NO RESPONSE TO SPO MESSAGES 
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1. 


2. 


z 
ve 


Analyze clear start message. 


Take ROM dump. 


WHEE system WARMSTART? 


1) 


2) 


If no: 


Analyze WARMSTART fallure code. 


be Relace system files, and rewarmstart. 

ce Run MTRs. 

If yes: 

ae Print and analyze fog files. 

be Print and analyze KA and LR of all disks on line at time of 
CLEAR/START. 

c+ Run ROMANALYZER and analyze IC status words. 

de Run ROMCONVERT and SYSANALYZER. 

e- Run MIRs. 

f. Analyze appropriate areas for hardware errors. 


if reason for CLEAR/START Is not found In steps aor b, submit FTR- 


1. 


2. 


Attempt a ROM dump. 


1) 
2) 


1) 


2) 


If ROM does not take dump, run MTR. 

If ROM dump is taken, attempt to WARMSTART. 
Wilt system WARMSTART? 

If no: 


ae 
be 
Ce 


Analyze WARMSTART fallure code. 
Replace system files. 
Run MTRs. 


If yes: 


ae 
De 


Ce 
de 


Print and analyze log files. 

Print and analyze KA and LR of all disks online at time of 
CLEAR/START. 

Run ROMANALYZER, and analyze IC status words. 

Run ROMCONVERT and SYSANALYZER. 


e. Run MTRs. 
a. Analyze appropriate areas for hardware errors. 


3) If reason for "hang" Is not found In steps a or b, submit FTRe 


CONDITION 4: TASK PROCESSOR MARKED NOT READY - DUMP 
CREATED 


Does the system have an MPL processor available? 


1. If yes: 
1) Print and analyze tog files. 
2) Print and analyze a KA and LR of all disks online at time 
of failure. 
3) "PO" system and run MTR- 
4) Run SYSANALYZER and analyze appropriate areas. 
5) If the reason for the task processor belng marked not ready 
Is not found In steps 1), 2), or 3), submit FTR. 
2. If no: 
1) "PO" system and WARMSTART. 
2) WII the task processor run "PL"? 
ae If yes: 
a) Print and analyze fog files. 
b) Print and analyze a KA and LR of all disks online 
at time of fallure. 
c) Run MTR. 
d) Run SYSANALYZER and analyze appropriate areas. 
e) If the reason for the task processor being marked 
not ready Is not found In above step, submit FTR. 
b. If no: 
a) Replace system files. 
b) Run MTRs- 


SYSTEM CONFIGURATION 2 

System aborts on a system without a printer 

CONDITION 1: CLEARSTART - DUMP CREATED 
1. Analyze CLEAR/START message- 
2. WII! system WARMSTART? 


1) If no: 
ae Analyze WARMSTART fallure code. 
be Replace system files. 
ce Run MTRs- 
2) ‘If yes: 
ae Run PL with display option and analyze any entries. 
be Run MTR. 
ce If the reason for the CLEAR/START Is not found by steps 1) 


or 2), submit FTR. 

a) Run KA and LR to printer backup. 

b) Copy dumpfile, printer backup files, and fog files to a 
removable disk, and transport to a system with a 
printer for further analysis. 

c) If the reason for the CLEAR/START Is not found by the 
above step, submit FTR. 


CONDITION 2: CLEARSTART - DUMP NOT CREATED 
1. Analyze CLEAR/START message. 
2. Set the OPERATE/MEM DUMP switch to MEM DUMP. 


3. Interrogate the contents of the OS processor page 0 of fsets O00F 
through O01C memory. (Refer to CMS SOG.) 


See NOTE 2 for OS save state area. 
4. Take ROM dump. 
5- WII! system WARMSTART? 


1) If no: 
ae Analyze WARMSTART fallure code. 
be Replace system files. 
ce Run MTRs. 


2) If yes: 

a» Run PL with display option and analyze any entries. 

be Run MTR. 

ce Run KA and LR to printer backup. 

d- Copy printer backup files and log files to a different 
removable disk than used for the ROM dump, and transport to 
a system with a printer for further analysis. 

e. If the reason for the CLEAR/START Is not found In the above 
step, submit FTR. 


CONDITION 3: SYSTEM HUNG - NO RESPONSE TO SPO MESSAGES 


1. Attempt to display the contents of the OS processor page 0 
offsets OOOF through OOIC memory. (Refer to CMS SOG.) 


1) If ROM does not display, run MTR. 


2) If ROM does display, analyze using layout described In step 3 
of the previous condition. 


2. Attempt a ROM dump. 


1) If dump not taken, run MTR. 
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CONDITION 4: TASK PROCESSOR MARKED NOT READY - DUMP 
CREATED 


2) If dump taken, attempt to WARMSTART 


be 


If 
a) 
b) 
c) 
If 
a) 
b) 
c) 
d) 


e) 


no: 

Analyze WARMSTART failure code. 

Replace system files. 

Run MTRs- 
yes: 

Run PL with display option and analyze any entries. 
Run MTR. 

Run KA and LR to printer backup. 

Copy printer backup files and log files to a different 
removable disk than used for the ROM dump, and 
transport to a system with a printer for further 
analysts. 

If the reason for the "hang" Is not found In the pre- 
vious step, submit FTR- 


Does the system have an MPL processor available? 
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1. 


2. 


If yes: 


1) 
2) 


3) 


4) 


5) 


If 
1) 
2) 


Run PL with "dispiay® option and analyze any entries. 
Run MTR. 
Run KA and LR to printer backup of al! disks online at time 


of 


fallure. 


Copy printer backup files, log files and memory dumpfile to 
removable disk, and transport to a system with printer for 
further analysis. 


If 


the reason for the failure was not found In the above 


step, FTR. 


no: 


"PO" system and WARMSTART. 
WHI the task processor run PL with the display option? 


b. 


If yes: 

a) Analyze any entries. 

b) Run MTR. 

c) Run KA and LR to printer backup of all disks online 
at time of fallure. 

d) Copy printer backup fifes, log files, and memory 
dumpfile to removable disk and transport to a 
system with printer for further analysts. 

e) If the reason for the fallure Is not found [n the 
above step, submit FTR. 

If no: 

a) Replace system files. 

b) Run MTRs. 


SYSTEM CONFIGURATION 3 


System aborts with no SPO and no printer. 


It will be very difficult to determine the time and type of failur 


a failure has occurred, the following steps can be followed: 
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1. Attempt to display the contents of OS and disk processors save 
state areas. See NOTE 2. 


1) If ROM does not display, run MTR. 


2) If RO displays, analyze using the layout provided In system 
configuration 2 condition 2. 


2. Attempt a ROM dump, then run the MTR. 


3. WILT the system WARMSTART? 


1) If no: 


Analyze the WARMSTART error code. 


be Replace system files. 
2) If yes: 
a Run KA and LR to printer backup of all disks on line at 
time of fallure via the remote SPO. 
b. Copy printer backup files and log files to a different 


NOTE 1: 


NOTE 2. 


removable disk. 


If there was not sufficlent disk space at WARMSTART time to 
create an empty dump file, a dump will not be taken In the 
event of a CLEAR/START, even If the system had the ability 
to do soe This case does not apply for this part of the 
outline because a ROM dump would not reflect the condition 
of the memory at the time of the failure. 


Disk Processor Hard Errors: When causing freeze, these wil! 
display "FO0000" on the hex Indicators: an unexpected "not 
ready", (select lock, 211 relocation table full, for 
example) can cause the system to eventual ly hang walting on 
virtual memory. 


IC status Is stored at the end of disk processor memory, 
Indicated by "OP-SIZE" tn a dump. tt Is stored as status 1, 
error status, status 3, status 2. 


"DP-SIZE" Is located at memory address @003A@ on page 0 of 
the disk processor. 


e on this system cofiguration. Once 


NON-OS PROCESSORS 


Errors on these processors cause values to be saved at the following addresses in their own memories: 


Address Length Stored |tem 
000B 1 ERROR INDICATOR 
000c 1 BO 
000D 1 REQ 
OO0E 2 BIFL 
0010 2 B32 
0012 1 AD 
0013 2 J 
0015 2 K 
0017 2 L 
0019 8 XY 
0021 2 Mt 
0023 2 M2 
0025 2 WR 
0027 2 MAX 
002 2 MXA 
0028 2 MXB 
0020 2 UMAR3 
002F 2 UMAR4 
0031 2 UMARS 
0033 2 UMAR6 

NOTE 


ERROR INDICATOR = 00 = Hardware detected error. 


OS PROCESSOR 


Hard errors on the OS processor cause values to be saved at the following addresses on page 0: 
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Address 


OOOF 


oo11 


0013 


0015 


0017 


0019 


OO1A 


0018 


001C 


Stored | tem 


M1 


M2 


MAX 


UMR2 


UMRX2 


STATUS 1 


ERROR STATUS 


STATUSS 


STATUS2 


Length 
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APPENDIX F 


GLOSSARY OF COMMON TERMS 


This glossary only includes terms and abbreviations that are global to the system. Many terms are ex- 
plained in the appropriate place within the ““SSYSANALYZER output’’ sections of this document. 
Throughout this document, the first definition will be implied unless explicitly specified otherwise. 


Several terms are described as ‘‘CMS standard.*’ These are further described 


NOTE 


in the CMS MCP Manual. 


ABP 


Action 


Activity 


AM-ACTION.LIST 


AYR 


BSMD 


CPA 


Critical 


CST 


DA 


DA CT 


Avallable Buffer Pool. The poo! of available data 
comm buffers. Managed by DCA. 


A discrete unit of code achleving a_ single 
function. 


A logically related group of system functions 
comprised of a set of Interdependent actions. 


Activity Management. An OS activity. See Section 
8 for a concise description. 


A \Inked list of status blocks, one block per 
active OS action. 


Automatic Volume Recognition. CMS standard. 


Basic Data System . The underlying microprocessor 
see "NBDS" and "NPRO." 


Block Descriptor. See Task Processor, Section 10. 
Burroughs Super MIni-DI sk. 

Cartridge Disk Control. 

Computer Management System. CMS standard. 
Communicate Parameter Area. CMS standard. 

An action Is known as critical If [t+ ts not re- 
entrant. Area of an action, known as a region, may 
be critical without the whole = action belng 
critical. Both actions and regions may be critical 
because they Invoke a critical action. 


Code Segment Tables CMS standard. 


Data Access. The OS activity handling all data 
operations. See Section 8. 


Data Access Configuration Table. 


0c | 


DCP 


DMTR 


DS&M 


OP 


pscp 


FOC 


FPB 


Frozen 


-HCT 


JC 


Data Comm. Usually used with reference to data 
storage areas of the data comm activity. 


Data Comm Activity. OS activity for handling all 
data comm commumicates. See Section 8. 


Data Communications Interface control. That part of 
the DCP hardware that enables the connection of an 
external iIne to the data comm processor. 

Data Communications Processor. 

Display and Malintainance Test Routine control. 
That part of the DS&M processor hardware 
responsible for handling the hexadecimal keypad, 
the displays, and the MTR switches. 

Data Storage and Malntenance processor. 


Dftsk Processor. Same as DS&M. 


Data Storage Control Program. The firmware that 
executes In the DS&. 


Fixed Disk Control. 


Fite information Biock.e For a user fiie this fs a 
reflection of a user FPB. 


File Parameter Blocke CMS standard. 


1. A frozen processor fs an NPRO that has 
deliberately stopped Itself. 


2. A frozen segment Is an element of managed memory 
(in any processor) that cannot be swapped out or 
moved. 


History Communicate Table. 


Interface Control. The hardware interface to the 
Processor Interconnect Bus. 


Interpreter Control Block. CMS standard. 
Industry Compatible Mini-Disk. 


interpreter Control Programe The firmware that 
runs tn the task processor. 


Job Control. The ICP activity that schedules and 
controls the execution of user Jobs within the task 
processor « 
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Jel led 


JM 


LB 


LSB 


Mall box 


MCS 


Mtx Number 


Mon ftor 


MSB 


NBDS 


NPRO 


ODT 


Ol 


os 


A jelled segment Is an element of managed memory 
that may not be swapped out, but which may be 
moved. See frozen. 


Job Management. The OS activity for Job related OS 
functions. See Section g. 


Linked Block. 


Least Significant Bit or Byte (depending on the 
context). 


The communication area of two processors. The 
content and use of mailboxes Is covered In sections 
2 and 10. 


Master Contro! Program. Generic Burroughs term for 
an operating system- See CMS MCP Manual for 
speci fic CMS Implementations. 


Message Control! System. A user program responsible 
for controlling al! or part of a data comm network. 


External user reference to a running Jobe Mix 
numbers are assigned fron 1 to 99 In a round-robin 
manner. 


NOTE 


Internally the system uses a (different) task ID. 
Both are kept In the mix table. 


Monitor. 
The OS activity responsible for system and error 
logging and the detection of peripheral device 


errors. See Section 8. 


Most Significant Bit or Byte, depending on the 
context. 


An n-channel! BDS processor. See also BDS and NPRO. 


The standard processor module- An extended n- 
channel BOS microprocessor. 


Operator Display Terminal. 


Operator Interface. The OS activity handling all 
operator messagese The activity also handles 1/0 
to the OOT directly. See Section 1. 


Operating system. That portion of the MCP that 
runs In the OS processor, and the processor Itself. 
See Section 8. 


F-3 


F-4 


PCB 


PD 


PHT 


Pi 


PIB 


Port 


Region 


RSO 


RTC 


Section 


Program Control Block. 


1. Physical Descriptor. Used In relation to task 
and buffer memorles. 


2. MCP utlIity to report all or part of a disk 
directory. 


Peripheral Handling Table. Used by DA to manage 
all peripherals attached to the system (other than 
data comm). 


Processor Interface. A group of related modules of 
code appearing as one activity In all processors 
(other than the 0S8M) that communicate with one 
another. Pl provides a processor to processor 
communication capability via the processor 
Interconnect bus. 


Processor Interconnect Bus. The hard bus 
connecting the IC modules of each processor 
subsystem. 


Processor Interface Control. Same as PIB and IC. 


Processor Management. The ICP activity responsible 
for the control of the task processor. 


Power Off. The MCP Intrinsic used to request the 
system to logical ly release a disk peripheral. 


The 1/0 path of the NBDS. Each NBDS has the 
capability of addressing efght ports. Port 0 (and 
port 1 In the OS processor and DS&M) Is reserved 


for Interprocessor communication. 


A sub portion of an action. The term Is normal ly 
oniy used in the context of c 


Remote SPO Operation. A system capability to allow 
the ODT function to be transferred to a remote 
device via an MCS. 

Real Time Clock. Also known as TOD (Time Of Day). 
Status Block. See status block. 

System Control Language. Standard CMS. 

Segment Descriptor. 

A portion of buffer memory. Usually a part of a 


buffer of user data. Currently a section fs 180 
bytes. 
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SPO 


Stack frame 


Status Block 


STE 


Task ID 


TCB 


TOD 


WLP 


Work Block 


Alternative mnemonic for ODT. 


An Internal save area maintained for every action 
on a soft stack. 


A standard storage area reflecting the current 
status of an action. Active entries appear In the 
AM.ACTION-LIST. 

Segment Table Entry. 


The Internal reference to a Jobe This number Is a 
direct Index Into the mix table. See mix number. 


Task Control Blocks CMS standard. 


Time Of Day. Alternative name for the real time 
clock. 


Task Processor. 

Virtual Memory. 

Work Block. 

Wide Line Printer. 1/0 contro! for !Ine printers. 


A Work Block Is owned by an action, and Is used for 
a varlety of data storage purposes. 
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ized in ensuing revisions to improve this manual. 


Please check type of Suggestion: 


O Addition O Deletion 0 Revision O Error 


Comments: 


From: 
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Address 
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Remove form and mail to: 


Documentation Dept, TIO - East 
Burroughs Corporation 
Box CB7 
Malvern, PA 19355 
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